References.AddActiveX أسلوب

قم بإضافة مرجع إلى مكتبة نوع ActiveX.

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

بناء الجملة

'إقرار
Function AddActiveX ( _
    bstrTypeLibGuid As String, _
    lMajorVer As Integer, _
    lMinorVer As Integer, _
    lLocaleId As Integer, _
    bstrWrapperTool As String _
) As Reference

Reference AddActiveX(
    string bstrTypeLibGuid,
    int lMajorVer,
    int lMinorVer,
    int lLocaleId,
    string bstrWrapperTool
)

Reference^ AddActiveX(
    [InAttribute] String^ bstrTypeLibGuid, 
    [InAttribute] int lMajorVer, 
    [InAttribute] int lMinorVer, 
    [InAttribute] int lLocaleId, 
    [InAttribute] String^ bstrWrapperTool
)

abstract AddActiveX : 
        bstrTypeLibGuid:string * 
        lMajorVer:int * 
        lMinorVer:int * 
        lLocaleId:int * 
        bstrWrapperTool:string -> Reference 

function AddActiveX(
    bstrTypeLibGuid : String, 
    lMajorVer : int, 
    lMinorVer : int, 
    lLocaleId : int, 
    bstrWrapperTool : String
) : Reference

المعلمات

• bstrTypeLibGuid
  النوع: System.String
  مطلوبة.نوع للمكتبة معرف فريد عمومي (معرّف فريد عالمي)، يتم التعبير عنها كسلسلة.

• lMajorVer
  النوع: System.Int32
  اختياري.رقم الإصدار الرئيسي.إذا تم حذفها, 0 هو المستخدمة.

• lMinorVer
  النوع: System.Int32
  اختياري.رقم الإصدار الثانوي.إذا تم حذفها, 0 هو المستخدمة.

• lLocaleId
  النوع: System.Int32
  المعرف اللغة المسمى اختيارية.لمزيد من المعلومات، راجع LocaleID.

• bstrWrapperTool
  النوع: System.String
  برنامج تضمين أداة المراد استخدامه عند إنشاء تجميع برنامج تضمين لمكتبة النوع.قيم المدعمة موصوفة في الجدول التالي.

  Value	النتيجة
  "tlbimp"	ينشيء النظام مشروع مجمع عام مناسبة للوصول إلى كائن COM's الأساليب والخصائص.
  "aximp"	ينشيء النظام مشروع مجمع Windows Forms يستخدم لاستضافة ActiveX.
  "" (سلسلة فارغ)	يتحقق النظام مشروع إذا تجميع إمكانية التشغيل التفاعلي الأساسي للنوع المحدد مكتبة موجود.إذا وجد، ثم هذا تجميع هو المستخدم كما يقوم برنامج التضمين لأساليب وخصائص لكائن COM.إذا غير موجود، سلوك هو نفسه كما لو كان "tlbimp" تم تحديد.

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

النوع: VSLangProj.Reference
بإرجاع Referenceكائن لمكتبة ActiveX المطلوب كائن.

ملاحظات

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

التنسيق الصحيح معرّف فريد عالمي هو "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"، الموقع X رقم ست عشري (0,1,2,3,4,5,6,7,8,9، أ، ب، ج، D، E, F). أسلوب واحد لتحديد معرّف فريد عالمي لكائن ActiveX هو لعرض الملف.ocx أو.tlb استخدام dهوtributed الأداة Oleview.exe Studio Vهوual.

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

إذا تلقيت "مكتبة لا مسجَّل" خطأ عند الرجوع إلى كائن COM صالح، فستكون غالباً السبب إلى قيامك أن غير الذي يتم تمرير صالح lMajorVerالقيمة معلمة إلى AddActiveXالأسلوب. بشكل افتراضي، AddActiveXيستخدم القيمة 0 لكل شيء ما عدا معرف فريد عمومي. في حالة الإصدار الكائن COM، على سبيل المثال، 1، سيفشل الاتصال نظراً لوجود لا مسجَّل الإصدار typelib 0. على سبيل المثال، عند استدعاء الإصدار 1.0 من Windows وسائط مشغل

ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}")

ينتج الخطأ السالف، ولكن

ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}", 1)

إلى العمل بشكل صحيح.

سيضيف هذا الأسلوب مكتبة نوع مسجلة فقط. مكالمة هو التي تم إجراؤها على QueryPathOfRegTypeLib، دالة واجهة برمجة تطبيقات أتمتة (التنفيذ التلقائي سابقا OLE)، وتمرير المعلومات المتوفرة AddActiveXالأسلوب.

إذا كانت ملف يعرف اسم كائن ActiveX، يمكن تمت الإضافة الكائن باستخدام Add. Addأسلوب لا تتطلب المعرف فريد عمومي أو الإصدار اللغة المعرف.

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

لمزيد من معلومات تشغيل COM wrappers كائن ActiveX استضافة والتجميعات إمكانية التشغيل التفاعلي الأساسية، راجع Tlbimp.exe (مستورد مكتبة الأنواع)و Aximp.exe (مستورد عنصر تحكم ActiveX Windows Forms).

أمثلة

' Macro Editor
' Add a reference to the ActiveX Data Objects Library, Version 2.5
Imports VSLangProj
Public Sub AddARef()
   Try
      Dim proj As VSLangProj.VSProject = _
         CType(DTE.Solution.Projects.Item(1).Object, _
         VSLangProj.VSProject)
      ' GUID for ActiveX Data Objects, version 2.5
      proj.References.AddActiveX( _
      "{00000205-0000-0010-8000-00AA006D2EA4}", 2, 5)
   Catch ex As System.Exception
      MsgBox("Cannot add that reference.")
   End Try
End Sub

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

References واجهة

References الأعضاء

VSLangProj مساحة الاسم