مشاركة عبر

References.Add أسلوب

  • مقالة

قم بإضافة مرجع جديد إلى المشروع.

مساحة الاسم:  VSLangProj
التجميع:  VSLangProj (في VSLangProj.dll)

بناء الجملة

'إقرار
Function Add ( _
    bstrPath As String _
) As Reference

Reference Add(
    string bstrPath
)

Reference^ Add(
    [InAttribute] String^ bstrPath
)

abstract Add : 
        bstrPath:string -> Reference 

function Add(
    bstrPath : String
) : Reference

المعلمات

  • bstrPath
    النوع: System.String
    مطلوبة.مسار مرجع COM أو NET Framework.
    قد تستغرق هذه معلمة النماذج الثلاثة:

    • كائن.NET Framework بسيطة للاسم، مثل كـ "النظام".

    • .NET Framework اسم الملف (ملف.tlb أو.dll.ocx).

    • ملف مكتبة COM (ملف.tlb.dll،.ocx أو.exe). لكائنات COM، يجب تضمين مسار كامل مسار و ملف الاسم، على سبيل المثال، "D:\SomeApplication\SomeApp.dll". إضافة مراجع ملف.exe COM راجع القيود الموجودة في قسم "المراجع" COM "أدناه.

القيمة المُرجعة

النوع: VSLangProj.Reference
إرجاع الكائن Reference.

ملاحظات

يتم إنشاء خطأ إذا كانت هناك مكتبات نوع لا يوجد في ملف المشار إليها بواسطة bstrPathيتعذر حل معلمة أو المرجع (راجع مقطع مرجع الحل).

لا يقوم هذا الأسلوب بإنشاء خطأ في حالة وجود مرجع في مشروع باستخدام نفس Identity، Culture، MajorVersion، MinorVersion، BuildNumber، و RevisionNumberكـ المرجع الجديد. أن الشرط قد تشير إلى أن المرجع المشار إليه بواسطة bstrPathمعلمة قد تم بالفعل تمت الإضافة إلى مشروع. بدلاً من ذلك، ProjectItemمرجع مطابق موجود بالفعل في مشروع هو التي يتم إرجاعها.

إذا كان مرجع باستخدام نفس Identityولكن يوجد تباين MajorVersion، MinorVersion، BuildNumber، RevisionNumber، أو Cultureالموجود في مشروع، أسلوب يقوم بإنشاء خطأ.

لإزالة مرجع، استخدام Remove.

مراجع COM

هذا الأسلوب بإرجاع Referenceكائن للأول نوع مكتبة في الملف الذي يتم الرجوع إليها.

وهذا أسلوب إضافة الجميع الكائنات التي تم العثور عليها في ملف مكتبة نوع وتبعيات أي من هذه الكائنات. ولذلك، قد يؤدي استدعاء هذا الأسلوب مفرد في مرجع مفرد أو المزيد التي يتم إضافتها إلى Referencesمجموعة.

يمكن تمت الإضافة ملفات.exe COM كمراجع، إذا كانت تحتوي على مكتبات النوع. في هذه حالة، يشير إلى الجميع مسجَّل تتم تمت الإضافة مكتبات نوع المضمنة في ملف.exe.

مراجع إطار عمل.NET

هذا الأسلوب بإرجاع Referenceكائن للتجميع قيد مرجع.

هذه المراجع لم يكن ملف مكتبة نوع، حيث تتم تمت الإضافة تجميعات التابعة لا كمراجع إلى المشروع.

إذا كان مرجع يتم تجميع تم تضمينها أيضا مكتبات النوع فقط مرجع تتم تمت الإضافة إلى التجميع.

يشير إلى.NET مسموح بإطار عمل ملفات exe.

مرجع حل المشكلة

عند ملف مشروع هو تم الحفظ المسارات للا يتم تم الحفظ المراجع كجزء من مشروع. يسمح هذا مشروع ملف يمكن مشاركته بين أجهزة الكمبيوتر أكثر بسهولة. تشغيل سبيل المثال، النظام.dll ربما تكون مخزنة في C:\Bigfolder تشغيل الكمبيوتر أ، و ربما تكون مخزنة في D:\Smallfolder تشغيل الكمبيوتر "ب". الحصول على مراجع من برنامج.NET Framework، اسم تجميع مرجع فقط هو persهوted. ولذلك، ل System.dll، "النظام" هو الدائمة.

compilers فقط بقبول المراجع في شكل علامة زائد مسار الكامل ملف تسمية، على سبيل المثال، C:\Bigfolder\النظام.dll. ولذلك، يجب أن يكون هناك بعض متناسق من تحديد مواقع تجميعات في وقت التصميم. تجميع هو حل إذا كان يمكن وضع مسار الكامل للتجميع. تحليل مسار هو مسار الكامل مرجع. متابعة المثال النظام، إذا System.dll هو تم العثور عليها في C:\Bigfolder، ثم عندما System.dll هو حل مساره حل هو C:\Bigfolder\System.dll.

إلى حل مرجع، بيئة التطوير إنشاء اسماً لبحث عن المرجع ويبحث عن المرجع. يتم تاريخ الإنشاء اسم بحث لكي يشتمل الملحق dll.، منذ اسم محفوظ مرجع قد أو قد لا يتضمن الملحق dll.. الاثنين مراجع، ReferenceOne ReferenceTwo.dll، سيتم منحك والأسماء، ReferenceOne.dll و ReferenceTwo.dll، على التوالي.

بيئة التطوير يبحث عن اسم بالترتيب التالي، إيقاف مجرد مطابقة هو العثور على:

  1. في هيكلي للمشروع.

  2. في مسار بحث المراجع التي هو إعداد المستوى مشروع. لمزيد من المعلومات، راجع ReferencePath.

  3. في التعيين الدلائل منتقي مكوّن يستخدم عند تعداد المراجع. Th هو مجموعة من الدلائل هو المخزنة في regهوtry أثناء التثبيت.

كل مرجع هو حل عند مشروع هو تم تحميله. دقة تحدث أيضا تشغيل جديد مرجع عند bstrPath Addأسلوب آخر بخلاف مسار. كامل

في حالة تعذر حلها، مرجع خطأ هو التي تم إنشاؤها. مراجع COM دوماً سيتم حلها، لأن اسم مسار الكامل هو المطلوبة في bstrPathمعلمة. إذا bstrPathهو معلمة اسم إطار عمل.NET (على سبيل المثال، SomeObject) أو اسم ملف من برنامج.NET Framework بدون مسار (على سبيل المثال، SomeObject.dll)، ثم من الممكن أن المرجع قد لا يمكن حلها، و فسيتولد خطأ.

أمثلة

' Macro Editor
Imports VSLangProj
Sub AddExample()
   ' This example assumes that the first project in the solution is 
   ' either a Visual Basic or C# project.
   Dim aVSProject As VSProject = _
      CType(DTE.Solution.Projects.Item(1).Object, VSProject)
        
   Dim refs As References = aVSProject.References
   ' Adds a reference to a compiled .NET project.
   refs.Add("C:\path\program.dll")
   ' Adds a reference to an installed ActiveX control.
   refs.Add("C:\WINNT\system32\msmask32.ocx")
   ' Adds a reference to System.dll as an example of adding a
   ' reference using just the simple name.
   refs.Add("System")
End Sub

أمن NET Framework.

راجع أيضًَا

المرجع

References واجهة

References الأعضاء

VSLangProj مساحة الاسم