استيراد كشف (مساحة الاسم و نوع NET.)

مقالة
11/01/2010

استيراد مساحات الاسم أو عناصر البرمجة المعرّفة في المشروع الحالي أو في المشاريع المشار إليها و التجميعات.

Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element

الأجزاء

aliasname
اختياري. استيراد اسم مستعار أو الاسم التعليمة البرمجية الذي يمكن أن تشير إلى namespace بدلاً من سلسلة التأهيل الكامل. انظر أسماء العنصر المعرف
namespace
مطلوبة. الاسم المؤهل بشكل كامل في مساحة الاسم الذي يتم استيراده. يمكن أن تكون سلسلة من مساحات الاسم متداخلة في أي مستوى.
element
اختياري. تم تعريف اسم عنصر البرمجة في مساحة الاسم. يمكن أن يكون أي عنصر حاوية.

ملاحظات

يمكن أن تحتوي كل ملف المصدر على أي عدد من عبارات Imports . يجب أن يتبع أي تعريفات للخيار مثل عبارة Option Strict و يجب أن تسبق عنصر البرمجة التعريفات ، مثل عبارات Module أو Class .

يمكنك استخدام Imports فقط في مستوى الملف. وهذا يعني تعريف السياق لدالة يجب أن يكون فئة، بنية، وحدة نمطية، أو واجهة و لا يمكن أن يكون ملف المصدر، مساحة الاسم،إجراء أو مقطع .

استيراد أسماء مستعارة مفيدة عندما تحتاج إلى استخدام العناصر بنفس الاسم التي تم تعريفها في مساحات الأسماء أو أكثر. لمزيد من المعلومات وللحصول على مثال راجع "مؤهلة اسم عنصر" مراجع لعناصر معرّفه.

لاحظ أن عبارة Imports لا تجعل عناصر من مشاريع و تجميعات أخرى متوفر إلى المشروع. استيراد لا يأخذ مكان تعيين مرجع. يزيل فقط الحاجة إلى تأهيل الأسماء التي تتوفر بالفعل إلى مشروع. للحصول على المزيد من المعلومات، راجع "استيراد العناصر المتضمنة" في مراجع لعناصر معرّفه.

ملاحظة

على الرغم من أنه تم استخدام بناء الجملة المستخدم للتصريح عن استيراد مستعار مثل تلك الاستيراد على بادئة مساحة الاسم XML النتائج مختلفة. هناك عملية استيراد اسم مستعار يمكن استخدامه كتعبير في تعليمات برمجية الخاصة بك بينما بادئة مساحة الاسم XML يمكن أن يتم استخدامها في القيم الحرفية XML أو خصائص محور XML البادئة للحصول على اسم عنصر أو سمة مؤهل.

القواعد

اسم مستعار يجب أن لا تقوم بتعريف عضو في المستوى وحدة نمطية بنفس اسم كـ aliasname. إذا قمت بذلك، يستخدم برنامج التحويل البرمجي Visual Basic aliasname للعضو المُعلَن و لم يعد يتعرف عليها كـ استيراد اسم مستعار.
اسم مساحة الاسم. يمكنك توفير واحد من اسم مساحة الاسم أو سلسلة من متداخلة مساحة الاسماء. كل مساحة اسم متداخلة منفصلو عن مساحة الاسم المستوى أعلى التالي حسب فترة (.) ، كما يوضح المثال التالي.

Imports System.Collections.Generic
نوع العنصر إذا قمت بتزويدها element، يجب أن يمثل حاوية العنصر ، أي، برمجة عنصر يحتوي على عناصر أخرى. تتضمن عناصر حاوية فئات بنيات الوحدات النمطية واجهات و التعدادات.

السلوك

النطاق. نطاق العناصر التي توفيرها بواسطة عبارة Imports يعتمد على ما إذا قمت بتحديد element. إذا حددت namespace، يتم لكافة الأعضاء مساحة الاسم ذلك المسماة بشكل فريد والأعضاء حاوية عناصر داخل مساحة الاسم ذلك متوفر دون تأهيل. إذا حددت كلا namespace و element، الأعضاء لعنصر متوفرة دون تأهيل.
التأهيل. يجب أن يتأهل رمز خارج عنصر مساحة الاسم أو حاوية اسم العضو مع اسم مساحة الاسم لعنصر الحاوية. العبارة Imports يجعل مثل التأهيل غير الضرورية إلا إذا كان مشروع الخاص بك الوصول إلى عضو آخر بنفس اسم. في مثل هذه الحالة يمكنك تحديد aliasname في كل عبارة Imports . ثم تحتاج فقط استيراد الاسماء المستعارةلتأهيل الأعضاء بنفس الاسم.

مثال

يستورد المثال التالي الفئة Microsoft.VisualBasic.Strings وتُعين الاسم المستعار str، التي يمكن استخدامها للوصول إلى الاسلوب Left .

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings

Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

لاحظ أن المثال السابق يستورد مساحة متداخلة Strings ضمن VisualBasic ضمن Microsoft. عندما الدالة MsgBox تحاول الوصول إلى الاسلوب Left, يمكن استخدام اسم مستعار str بدلاً من سلسلة تأهيل بأكمله Microsoft.VisualBasic.Strings.