using — Dyrektywa (odwołanie w C#)

using Dyrektywy ma dwóch zastosowań:

• Aby zezwolić na użycie typów w przestrzeni nazw, tak aby nie kwalifikują się do użycia tego typu, w tym obszarze nazw:

  using System.Text;
  

• Aby utworzyć alias dla obszaru nazw lub typ.Jest to tak zwane za pomocą dyrektywy alias.

  using Project = PC.MyCompany.Project;
  

using Słowo kluczowe jest również używany do tworzenia za pomocą instrukcji, które pomagają zapewnić, że IDisposable obiektów, takich jak pliki i czcionki są obsługiwane poprawnie.Zobacz za pomocą instrukcji Aby uzyskać więcej informacji.

Uwagi

Zakres using dyrektywa ogranicza się do pliku, w którym się pojawia.

Tworzenie using alias, aby ułatwić kwalifikują się do obszaru nazw lub typ identyfikator.Prawej stronie przy użyciu aliasu dyrektywa musi być zawsze typu pełną, niezależnie od tego, za pomocą dyrektyw, które pochodzą przed nim.

Tworzenie using dyrektywy używać typów w przestrzeni nazw, bez konieczności określić obszar nazw.A using dyrektywy nie dają dostęp do wszelkich przestrzenie nazw, które są zagnieżdżone w obszarze nazw, można określić.

Przestrzenie nazw pochodzą w dwóch kategoriach: zdefiniowane przez użytkownika i zdefiniowane przez system.Zdefiniowane przez użytkownika nazw są obszary nazw zdefiniowane w kodzie.Listę nazw zdefiniowanych przez system, zobacz .NET Framework Class Library.

Przykłady odwoływania się do metod opisanych w innych zestawów, zobacz przy użyciu języka C# bibliotek DLL i tworzenie.

Przykład 1

Opis

Poniższy przykład ilustruje sposób zdefiniować i użyć using alias dla obszaru nazw:

Kod

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 { }
        }
    }
}

Komentarze

Za pomocą dyrektywy alias nie może być otwarty typ ogólny po prawej stronie.Na przykład nie można utworzyć przy użyciu alias dla listy <T>, ale można utworzyć jedną listę <int>.

Przykład 2

Opis

Poniższy przykład ilustruje sposób zdefiniować using dyrektywy i using alias dla klasy:

Kod

using System;

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

// Using alias directive for a generic class. 
using UsingAlias = NameSpace2.MyClass<int>;

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

}

namespace NameSpace2
{
    class MyClass<T>
    {
        public override string ToString()
        {
            return "You are in NameSpace2.MyClass.";
        }
    }
}

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

    class MainClass
    {
        static void Main()
        {
            AliasToMyClass instance1 = new AliasToMyClass();
            Console.WriteLine(instance1);

            UsingAlias instance2 = new UsingAlias();
            Console.WriteLine(instance2);

        }
    }
}
// Output:  
//    You are in NameSpace1.MyClass. 
//    You are in NameSpace2.MyClass.

Specyfikacja języka C#

Aby uzyskać więcej informacji, zobacz Specyfikacja języka C#. Specyfikacja języka jest ostatecznym źródłem informacji o składni i użyciu języka C#.

Zobacz też

Informacje

Słowa kluczowe języka C#

Słowa kluczowe przestrzeni nazw (odwołanie w C#)

Przestrzenie nazw (Przewodnik programowania w języku C#)

using — Instrukcja (odwołanie w C#)

Koncepcje

Przewodnik programowania w języku C#

Inne zasoby

Odwołanie w C#