ExpertiDict

C# · Essencial · Inglês · Técnico

using

/ˈjuzɪŋ/palavra-chave

Palavra-chave com dois usos: a diretiva importa um namespace, e o comando using garante que um IDisposable seja descartado ao sair do escopo, mesmo com exceção.

Onde usar

Todo arquivo C# começa com diretivas using, e todo code review sobre arquivos, conexões e streams pergunta se o recurso está dentro de um using. Esquecê-lo vaza handles e conexões.

Em código

using System.IO;
using (var r = new StreamReader("a.txt")) {
  Console.WriteLine(r.ReadLine());
}   // Dispose() chamado aqui

Exemplos

Wrap the reader in a using so it gets closed.

Envolva o reader em um using para ele ser fechado.

You forgot the using, so the connection leaks.

Você esqueceu o using, então a conexão vaza.

Cuidado

O erro comum é esquecer o using ao criar StreamReader ou SqlConnection: o recurso só será liberado quando o GC finalizar o objeto, em hora imprevisível.

Sinônimos

comando using

Veja também

Todos os termos de C#