المراجع و كشف عمليات الاستيراد

يمكنك جعل الكائنات الخارجية متوفرة للمشروع عن طريق اختيار الأمر إضافة مرجع من قائمة مشروع. المراجع في Visual Basic يمكن أن تشير إلى تجميعات مثل مكتبات الأنواع ولكنها تحتوي على معلومات إضافية.

عبارات عمليات الاستيراد

تتضمن التجميعات واحد أو أكثر من مساحات الاسم. عند إضافة مرجع تجميع يمكنك أيضاً إضافة عبارة Imports إلى الوحدة النمطية الذي يتحكم بالرؤية من مساحات الأسماء تلك ضمن الوحدة النمطية. العبارة Imports توفر سياق النطاق التي تسمح لك باستخدام جزء فقط من مساحة الاسم الضرورية لتوفير مرجع فريد.

العبارة Imports يحتوي بناء الجملة التالي:

Imports [| Aliasname =] Namespace

Aliasname يشير إلى اسم مختصر يمكنك استخدامها ضمن التعليمات البرمجية للإشارة إلى مساحة التي تم استيرادها. Namespace هي مساحة الاسم متوفر خلال إما مرجع مشروع، خلال تعريف ضمن المشروع أو خلال عبارة Imports السابقة.

وحدة نمطية قد يحتوي على أي عدد من عبارات Imports عبارات. يجب أن تظهر بعد أي عبارت Option، إذا كان موجوداً, ولكن قبل أي تعليمات برمجية أخرى.

ملاحظة

لا تخلط بين مراجع مشروع مع عبارة Imports أو العبارة Declare. مراجع مشروع توفّر كائنات خارجية مثل الكائنات في تجميعات ، إلى مشاريع Visual Basic. عبارة Imports يتم استخدامها لتبسيط الوصول إلى مراجع مشروع ولكن لا توفر الوصول إلى هذه الكائنات. عبارة Declare يتم استخدام العبارة بتعريف مرجع إجراء خارجي في مكتبة ارتباطات ديناميكية (DLL).

استخدام أسماء مستعارة مع عبارة عمليات الاستيراد

العبارة Imports يسهل الوصول لأساليب الفئات بواسطة إزالة الحاجة إلى نوع واضح من أسماء المؤهل من المراجع بشكل كامل. أسماء مستعارة تسمح لك تعيين اسم friendlier إلى جزء واحد فقط من مساحة الاسم. على سبيل المثال، أحرف ناقل الإرجاع / سلسلة سطر التغذية التي تسبب قطعة من النص ليتم عرضها في عدة أسطر هي جزء من الوحدة النمطية ControlChars في مساحة الاسم Microsoft.VisualBasic. لاستخدام هذا الثابت في برنامج بدون اسم مستعار قد تحتاج كتابة التعليمات البرمجية التالية:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

عبارات Imports يجب أن تكون دوماً الأسطر الأولى التالية مباشرة لأي عبارات Option في وحدة نمطية. جزء التعليمات البرمجية التالية يوضح كيفية استيراد وتعيين مستعار للوحدة النمطية Microsoft.VisualBasic.ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

يمكن أن تكون المراجع المستقبلية إلى مساحة الاسم أقصر بشكل كبير:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

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

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة أو إزالة المراجع في ‏‫Visual Studio

كيفية القيام بما يلي: إنشاء و استخدام التجميعات باستخدام خط الأوامر (C# و Visual Basic)

المرجع

التجميعات ومخزن التجميع العمومي المؤقت (C# و Visual Basic)

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

ControlChars

Microsoft.VisualBasic

المبادئ

مساحات الأسماء في Visual Basic