References.AddActiveX – metoda

Článek
05/16/2015

Přidá odkaz do knihovny typu ActiveX.

Obor názvů: VSLangProj
Sestavení: VSLangProj (v VSLangProj.dll)

Syntaxe

'Deklarace
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

Parametry

bstrTypeLibGuid
Typ: String

Povinné.Knihovna typů globálně jedinečný identifikátor (GUID), vyjádřeno jako řetězec.

lMajorVer
Typ: Int32

Nepovinné.Hlavní číslo verze.Pokud je tento argument vynechán, je používán 0.

lMinorVer
Typ: Int32

Nepovinné.Číslo podverze.Pokud je tento argument vynechán, je používán 0.

lLocaleId
Typ: Int32

Id národního prostředí volitelné.Další informace naleznete v tématu LocaleID.

bstrWrapperTool
Typ: String

Nástroj obálky při generování sestavení souhrnného seznamu stop pro knihovnu typů.Podporované hodnoty jsou popsány v následující tabulce.

[1|1] Hodnota

[1|2] Výsledek

[2|1] "tlbimp"

[2|2] Projekt systém generuje obecný obal vhodný pro přístup k objektu COM metody a vlastnosti.

[3|1] "aximp"

[3|2] Projekt systém generuje obal, který formuláře systému Windows používá pro hostování ActiveX.

[4|1] "" (prázdný řetězec)

[4|2] Projekt systém zkontroluje, pokud existuje primární interoperability sestavení knihovny zadaného typu.Pokud nalezen, sestava je použito jako obálky pro metody a vlastnosti objektu COM.Pokud není nalezen, chování je stejný jako "tlbimp" nebyly zadány.

Vrácená hodnota

Typ: VSLangProj.Reference
Vrátí Reference objekt pro požadovaný objekt ActiveX knihovny.

Poznámky

AddActiveX Metoda přidá odkazy na projekt pro zadaný objekt a závislosti uvedeny v objektu.Proto může způsobit více než jeden odkaz k jednomu volání této metody References kolekce.

Platný formát GUID je "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}", kde x je šestnáctková číslice (0,1,2,3,4,5,6,7,8,9, A, B, C, D, E, F).Jedna metoda pro určení identifikátoru GUID objektu ActiveX je soubor OCX nebo .tlb pomocí nástroje Oleview.exe distribuované s Visual Studio.

Pokud je již v kolekci odkaz se stejnou identitu, je generována chyba.

Pokud při odkazování na platný objekt COM zobrazí chybová "Knihovna není zaregistrována" a potom je pravděpodobně skutečnost, že není předáte platný lMajorVer hodnotu parametru AddActiveX metoda.Ve výchozím nastavení AddActiveX používá hodnotu 0 pro vše kromě identifikátoru GUID.Pokud je verze objektu COM, například 1, volání se nezdaří, protože není registrovaná verze 0 knihovnu typelib.Například při volání verze 1.0 programu Windows Media player

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

vytváří výše uvedené chyby, ale

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

funguje správně.

Tato metoda přidá knihovnu registrovaného typu.Při volání na QueryPathOfRegTypeLib, funkce rozhraní API automatizace (dříve automatizace OLE), předávání informací poskytnutých AddActiveX metoda.

Pokud název souboru objektu ActiveX je znám, objekt může přidat pomocí Add.Add Metoda nevyžaduje identifikátor GUID, verze nebo národní prostředí.

Chcete-li odebrat odkaz, použijte Remove.

Další informace o modelu COM objekt obálky, ActiveX hostování a interoperability primární sestavení viz Tlbimp.exe (importér knihovny typů) a Aximp.exe (importér ovládacích prvků ActiveX Windows Forms).

Příklady

' 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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

References Rozhraní

VSLangProj – obor názvů

Share via