Declaração using em C# (Como funciona para desenvolvedores)

Sintaxe e uso

A instrução using simplifica o processo de liberação de recursos não gerenciados. Isso garante que o método Dispose seja chamado em um objeto descartável assim que o objeto sair do escopo.

Considere o bloco using como uma zona de segurança que garante que os recursos sejam liberados automaticamente após o uso. Segue um exemplo básico para ilustrar seu uso:

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

using (StreamReader reader = new StreamReader("file.txt"))
{
    // You can read the file here
    // When the block is exited, the StreamReader's Dispose method is automatically called.
}

Using reader As New StreamReader("file.txt")
	' You can read the file here
	' When the block is exited, the StreamReader's Dispose method is automatically called.
End Using

No exemplo acima, StreamReader é uma classe que implementa a interface IDisposable . A instrução using garante que o método Dispose do leitor seja chamado automaticamente quando o controle sair do escopo definido pelas chaves.

Como funciona

Ao envolver um objeto descartável com uma instrução using , isso essencialmente se traduz em um bloco try com um bloco finally . No bloco finally , o método Dispose é chamado, garantindo que o recurso seja liberado corretamente mesmo se ocorrer uma exceção.

Se o código dentro do bloco using gerar um erro, não se preocupe; O método Dispose ainda será chamado, garantindo que os recursos sejam liberados com segurança.

Gerenciando múltiplos recursos

Você pode gerenciar vários objetos descartáveis ​​dentro de uma única instrução using . Essa abordagem mantém seu código mais limpo e garante que todos os recursos sejam descartados corretamente:

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

using (SqlConnection conn = new SqlConnection(connString))
using (SqlCommand cmd = new SqlCommand(query, conn))
{
    // Work with your database here
    // Both conn and cmd will be disposed of when the block is exited.
}

Using conn As New SqlConnection(connString)
Using cmd As New SqlCommand(query, conn)
	' Work with your database here
	' Both conn and cmd will be disposed of when the block is exited.
End Using
End Using

Usando a diretiva Alias

Além das funcionalidades principais da instrução using, o C# oferece recursos como a diretiva de alias using e o tratamento eficiente de variáveis ​​locais dentro de blocos using para simplificar ainda mais o gerenciamento de recursos e melhorar a legibilidade do código.

Às vezes, ao trabalhar com bibliotecas externas ou lidar com conflitos de nomes de classes, nosso código pode ficar confuso e difícil de acompanhar. A diretiva using alias vem em nosso auxílio, permitindo-nos atribuir um alias mais legível ou mais curto a um namespace ou classe.

Vamos considerar um cenário em que você está trabalhando com duas classes diferentes que têm o mesmo nome, mas residem em namespaces diferentes. Você pode usar a diretiva using alias para diferenciá-los facilmente:

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

using Project = FirstNamespace.Project;
using ExternalProject = SecondNamespace.Project;

// Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

Imports Project = FirstNamespace.Project
Imports ExternalProject = SecondNamespace.Project

' Now you can use Project and ExternalProject in your code to refer to the specific classes without confusion.

Declaração de Utilização

Introduzida no C# 8.0, a declaração using é um recurso sintático que torna seu código ainda mais conciso. Em vez de envolver o objeto descartável com chaves, você pode declará-lo diretamente, e ele será descartado ao final do escopo em que foi declarado.

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

using StreamReader reader = new StreamReader("file.txt");
// Use reader here
// It will be disposed of here automatically at the end of the scope.

Using reader As New StreamReader("file.txt")
	' Use reader here
	' It will be disposed of here automatically at the end of the scope.
End Using

Aulas personalizadas e descartáveis

Você também pode aplicar a instrução using a classes personalizadas implementando a interface IDisposable . Isso é particularmente útil quando sua turma é responsável por gerenciar um ou mais recursos:

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

public class ResourceHolder : IDisposable
{
    public void Dispose()
    {
        // Code to release your resources here
    }
}

Public Class ResourceHolder
	Implements IDisposable

	Public Sub Dispose() Implements IDisposable.Dispose
		' Code to release your resources here
	End Sub
End Class

Com sua classe implementando a interface IDisposable , você poderá usá-la dentro de uma instrução using da mesma forma que qualquer outro objeto descartável.

Instalando o IronPDF

A maneira mais eficiente de adicionar o IronPDF ao seu projeto é através do gerenciador de pacotes NuGet . Basta abrir seu projeto no Visual Studio, navegar até o "Solution Explorer", clicar com o botão direito em "Dependências" e escolher "Gerenciar Pacotes NuGet ". Lá, você pode pesquisar por "IronPDF" e instalar o pacote com apenas alguns cliques.

Exemplo de uso do IronPDF com a instrução using

Vamos relacionar isso com a instrução using em C# para gerenciamento de recursos. Abaixo, segue um exemplo de código simples que demonstra como usar o IronPDF para gerar um PDF a partir de conteúdo HTML, empregando a instrução using para garantir o descarte adequado de recursos:

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML string and save it
        using (var document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>"))
        {
            document.SaveAs("HelloIronPDF.pdf");
        }
        // The using statement ensures that resources are cleaned up correctly
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' Generate a PDF from HTML string and save it
		Using document = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>")
			document.SaveAs("HelloIronPDF.pdf")
		End Using
		' The using statement ensures that resources are cleaned up correctly
	End Sub
End Class

Licença

O IronPDF oferece diversas opções de licenciamento para diferentes necessidades, adequando-se a equipes de tamanhos variados e a diferentes requisitos de implantação, garantindo flexibilidade para desenvolvedores e organizações de todos os portes.

O preço da licença começa em $799. Oferece um período de teste gratuito dos recursos do IronPDF para que você possa experimentá-los antes de comprar.