/reference (خيارات المحول البرمجي #C)
الخيار /reference يجعل برنامج التحويل البرمجي يستورد معلومات النوع عام (C# مرجع) في الملف المحدد إلى المشروع الحالي وبالتالي تمكينك من أن تشير إلى بيانات التعريف من الملفات التجميع المحددة.
/reference:[alias=]filename
/reference:filename
الوسيطات
filename
اسم الملف الذي يحتوي على بيان التجميع . لاستيراد أكثر من ملف واحد قم بتضمين خيار /reference منفصل لكل ملف.alias
معرّف #C صالح سوف يمثل مساحة اسم الجذر التي سوف تحتوي على كافة مساحات الأسماء في التجميع.
ملاحظات
للاستيراد من أكثر من ملف واحد, قم بتضمين الخيار /reference لكل ملف.
يجب أن تحتوي الملفات المستوردة على بيان ظاهر ; ملف الإخراج يجب أن يكون تم تحويله برمجيا باستخدام أحد الخيارات /target (خيارات المحول البرمجي #C) و ليس /target:module (خيارات المحول البرمجي #C).
/r هو النموذج القصير من**/reference**.
استخدم /addmodule (خيارات المحول البرمجي C#) لاستيراد بيانات التعريف من ملف إخراج لا يحتوي على ملف بيان تجميع.
إذا أشرت إلى تجميع (التجميع A) الذي يشير إلى تجميع آخر (التجميع B) ، سوف تحتاج لأن تشير إلى التجميع B إذا:
نوع تستخدمه من التجميع A يرث من نوع أو يطبّق واجهة من تجميع B.
قمت باستدعاء حقل ,أو خاصية ،أو حدث ,أو أسلوب له نوع إرجاع أو نوع معلّمة من التجميعB .
استخدم /lib (خيارات المحول البرمجي C#) لتحديد الدليل الذي فيه واحد أو أكثر من مراجع التجميع الخاصة بك. الموضوع /lib يناقش أيضاً الدلائل التي يبحث المحول البرمجي فيها عن تجميعات.
لكي تعرف المحول البرمجي على نوع في تجميع و ليس في وحدة نمطية , لا بد من فرضه لحل النوع و الذي يمكنك إجراؤه بواسطة تعريف مثيل من النوع. هناك طرق أخرى لحل أسماء الأنواع في تجميع بالنسبة للمحول البرمجي: على سبيل المثال، إذا كنت ترث من نوع في تجميع , اسم النوع سيتم التعرف عليه بواسطة المحول البرمجي.
أحياناً من الضروري الإشارة إلى إصدارين مختلفين من نفس المكون من داخل تجميع واحد. لفعل ذلك، استخدم الخيار الفرعي ذو الاسم المستعار على المبدل /reference لكل ملف للتمييز بين كلا الملفين. سيتم استخدام الاسم المستعار هذا كمؤهل لاسم المكون ،و سوف يحلل المكون في أحد الملفات.
ملف استجابة csc (.rsp) ، الذي يشير إلى تجميعات .NET Framework التي تستخدم بشكل عام, يتم استخدامه بشكل افتراضي. استخدم /noconfig (خيارات المحول البرمجي C#) إذا لم تكن تريد المحول البرمجي أن يستخدم csc.rsp.
المثال
يوضح هذا المثال كيفية استخدام الميزة الاسم المستعار extern (C# مرجع) .
ترجمة الملف المصدر واستيراد بيانات التعريف من grid.dllو grid20.dll، التي قد تم تصنيف سابقا. تحتوي الـ DLLs الاثنتين على إصدارات منفصلة من نفس المكون ,و أنت تستخدم اثنين من /reference مع خيارات الاسم المستعار لترجمة الملف المصدر. تظهر الخيارات كما يلي:
/reference:GridV1=grid.dll و /reference:GridV2=grid20.dll
هذا يقوم بإعداد الأسماء المستعارة الخارجية "GridV1" و "GridV2," التي يمكنك استخدامها في برنامجك من كشف extern :
extern alias GridV1;
extern alias GridV2;
// Using statements go here.
حالما يتم هذا يمكنك الإشارة إلى عنصر تحكم الشبكة من grid.dll بواسطة الإضافة المسبقة لاسم عنصر التحكم مع GridV1 ، كما يلي:
GridV1::Grid
بالإضافة إلى ذلك، يمكنك الإشارة إلى عنصر تحكم الشبكة من grid20.dll بواسطة الإضافة المسبقة لاسم عنصر التحكم مع GridV2 مثل هذا:
GridV2::Grid