رهنمون using

رهنمون using دو کاربرد دارد:

• اجازه می دهد تا از نوع هایی که در فضای نام های دیگری تعریف شده اند به گونه ای استفاده کنیم که نیاز به نوشتن نام کامل آنها نباشد:
  

  using System.Text;

• برای ساختن یک نام مستعار برای یک فضای نام یا یک نوع؛ که به آن "using رهنمون نام مستعار" می گویند.
  

  using Project = PC.MyCompany.Project;

کلمه کلیدی using همچنین برای ساختن "بیان using" استفاده می شود که کمک می کند مطمئن شویم اشیاء IDisposable مانند فایل ها و فونت ها بدرستی مدیریت می شوند. برای اطلاعات بیشتر بیان using را ببینید.

ملاحظات

حوزه یک رهنمون using محدود به فایلی است که آن رهنمون در آن قرار دارد.

برای راحت تر تعیین کردن شناسه برای یک فضای نام یا یک نوع ، یک using نام مستعار بسازید. سمت راست یک using رهنمون نام مستعار، همیشه باید یک نوع کامل-تعریف شده بیاید؛ صرف نظر از خود رهنمون using ی که قبل از آن می آید.

برای استفاده از نوع های داخل یک فضای نام، بدون تعیین namespace آن نوع ها، یک رهنمون using بسازید. یک رهنمون using اجازه دسترسی به هیچکدام از فضای نام های تودرتوی داخل فضای نامی تعیین شده توسط شما را نمی دهد.

فضا نام ها (namespace) در دو دسته قرار می گیرند: کاربر-تعریف و سیستم-تعریف (تعریف شده توسط سیستم). فضای نام های کاربر-تعریف آنهایی هستند که در داخل کد شما تعریف شده اند. برای دیدن لیستی از فضای نام های سیستم-تعریف ، کتابخانه کلاس دات نت فریم وورک را ببینید.

مثال1

مثال زیر چگونگی تعریف و استفاده از using نام مستعار برای یک فضای نام را نشان می دهد:

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

یک using رهنمون نام مستعار نمی تواند دارای یک نوع جنریک باز در سمت راستش باشد. برای مثال، شما نمی توانید یک using نام مستعار برای یک <List<T بسازید، اما می توانید برای <List<int این کار را انجام دهید.

مثال2

مثال زیر چگونگی تعریف رهنمون using و using نام مستعار برای یک کلاس را نشان می دهد:

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