Compartilhar via


usando diretiva (translation from VPE for Csharp Reference)

The using diretiva tem dois usos:

  • Permitir que o uso de tipos em um namespace para que não é necessário que qualificar o uso de um tipo no espaço para nomes:

    using System.Text;
    
  • Para criar um alias para um namespace ou um tipo.Isso é chamado um usando a diretiva de alias.

    using Project = PC.MyCompany.Project;
    

The using palavra-chave também é usado para criar usando sistema autônomo instruções, que ajudam a garantir que IDisposable objetos sistema autônomo arquivos e sistema autônomo fontes são manipulados corretamente. See usando demonstrativo para obter mais informações.

Comentários

O escopo de um using diretiva está limitada ao arquivo em que aparece.

Criar um using alias para tornar mais fácil qualificar um identificador para um namespace ou tipo. O lado direito de um usando alias diretiva sempre deve ser um tipo totalmente qualificado independentemente do usando as diretivas que vêm antes dele.

Criar um using diretiva para usar os tipos em um namespace sem ter que especificar o namespace. A using diretiva não dá acesso a quaisquer espaços para nome aninhadas no namespace que você especificar.

Namespaces vêm em duas categorias: definidas pelo usuário e definidos pelo sistema.Espaços para nomes definido pelo usuário são espaços para nome definidos em seu código.Para obter uma lista dos espaços para nome definido pelo sistema, consulte Referência da biblioteca de classes .NET estrutura.

Para obter exemplos de métodos em outros assemblies de referência, consulte Criando e usando translation from VPE for Csharp DLLs.

Exemplo 1

Descrição

O exemplo a seguir mostra como definir e usar um using alias para um espaço para nome:

Código

namespace PC
{
    // Define an alias for the nested namespace.
    using Project = PC.MyCompany.Project;
    class A
    {
        void M()
        {
            // Use the alias
            Project.MyClass mc = new Project.MyClass();
        }
    }
    namespace MyCompany
    {
        namespace Project
        {
            public class MyClass { }
        }
    }
}

Comentários

Um usando diretiva de alias não é possível ter um tipo genérico em aberto no lado direito.Por exemplo, não é possível criar um alias using para uma lista <t>, mas você pode criar um para uma lista <int>.

Exemplo 2

Descrição

O exemplo a seguir mostra como definir um using diretiva e um using alias para uma classe:

Código

using System;   
// Using alias for a class.
using AliasToMyClass = NameSpace1.MyClass;   

namespace NameSpace1 
{
    public class MyClass 
    {
        public override string ToString() 
        {
            return "You are in NameSpace1.MyClass";
        }
    }
}

namespace NameSpace2 
{
    class MyClass 
    {
    }
}

namespace NameSpace3 
{
    // Using directive:
    using NameSpace1;
    // Using directive:
    using NameSpace2;   

    class MainClass
    {
        static void Main() 
        {
            AliasToMyClass somevar = new AliasToMyClass();
            Console.WriteLine(somevar);
        }
    }
}
// Output: You are in NameSpace1.MyClass

Especificação da linguagem C#

Para obter mais informações, consulte as seções a seguir no Especificação da linguagem C#:

  • 9.3 Usando diretivas

Consulte também

Conceitos

Guia de Programação C#

Referência

Palavras-chave C#

Palavras-chave namespace (translation from VPE for Csharp Reference)

Namespaces (Guia de programação C#)

usando demonstrativo (referência translation from VPE for Csharp)

Outros recursos

Referência C#