التوجيه using (مرجع #C)

للتوجيه using استخدامين:

  • للسماح باستخدام أنواع في مساحة الاسم بحيث لا يجب عليك تأهيل استخدام النوع في مساحة الاسم تلك:

    using System.Text;
    
  • لإنشاء اسم مستعار لمساحة الاسم أو لنوع. يسمى هذا توجيه اسم مستعار using.

    using Project = PC.MyCompany.Project;
    

يتم استخدام الكلمة الأساسية using أيضاً لإنشاء عبارات using التي تساعد في التأكد من أن تم معالجة كائنات IDisposable مثل الملفات والخطوط بشكل صحيح. لمزيد من المعلومات، راجع عبارة using.

ملاحظات

نطاق التوجيه using يقتصر على الملف الذي يظهر به.

قم بإنشاء اسم مستعار using لتسهيل عملية تأهيل معرّف لمساحة اسم أو لنوع. الجانب الأيمن من توجيه اسم مستعار using يجب أن يكون نوع مؤهل بالكامل بغض النظر عن توجيهات using التي تأتي قبل ذلك.

قم بإنشاء توجيه using لاستخدام أنواع في مساحة اسم دون الحاجة إلى تحديد مساحة الاسم. توجيه using لا يمنح حق الوصول إلى مساحات الاسم المتداخلة في مساحة الاسم الذي تحدده.

مساحات الاسم تأتي في فئتين: معرّفه من قبل المستخدم ومعرّفه من قبل النظام. مساحات الاسم المعرفة من قبل المستخدم هي مساحات اسم معرّفه في تعليماتك البرمجية. للحصول على قائمة من مساحات الاسم المعرفة من قبل النظام انظر مكتبة فئة NET Framework..

للحصول على أمثلة على الإشارة إلى أساليب في تجميعات أخرى، راجع إنشاء واستخدام C# DLLs.

مثال 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

مواصفات لغة #C

لمزيد من المعلومات، راجع مواصفات لغة #C. مواصفات اللغة هي المصدر النهائي لبناء جملة C# واستخدامها.

راجع أيضًا:

المرجع

الكلمات الأساسية لـ #C

الكلمات الأساسية لمساحة الاسم (مرجع C#)

مساحات الاسم (دليل البرمجة لـ #C)

عبارة using (مرجع #C)

المبادئ

دليل البرمجة لـ #C

موارد أخرى

مرجع C#‎