Sdílet prostřednictvím


References.AddActiveX – metoda

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: System.String
    Povinné.Knihovna typů globálně jedinečný identifikátor (GUID), vyjádřeno jako řetězec.
  • lMajorVer
    Typ: System.Int32
    Nepovinné.Hlavní číslo verze.Pokud vynechán, bude použita 0.
  • lMinorVer
    Typ: System.Int32
    Nepovinné.Číslo podverze.Pokud vynechán, bude použita 0.
  • lLocaleId
    Typ: System.Int32
    Id národního prostředí volitelné.Další informace naleznete v tématu LocaleID.
  • bstrWrapperTool
    Typ: System.String
    Nástroj obálky při generování sestavení obálky 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 obálky využívající Windows forms 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, pak toto sestavení slouží jako obalu 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 objekt požadované knihovny ActiveX.

Poznámky

AddActiveX Metoda přidá odkazy na projekt pro zadaný objekt a závislosti podle objektu. Proto jedno volání této metody může vést k více než jeden odkaz 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). Zobrazení souboru OCX nebo .tlb pomocí nástroje Oleview.exe distribuované s Visual Studio je jedna metoda pro určení identifikátoru GUID objektu ActiveX.

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

Pokud obdržíte "Knihovna není zaregistrována" Chyba při odkazování na platný objekt modelu COM je pravděpodobně skutečnost, že jsou procházející platný lMajorVer hodnotu parametru AddActiveX metody. Standardně AddActiveX používá hodnotu 0 pro vše kromě 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 bude přidat knihovnu registrovaného typu. Při volání na QueryPathOfRegTypeLib, funkci rozhraní API automatizace (dříve automatizace OLE) předávání informací poskytnutých AddActiveX metody.

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

Odebrat odkaz pomocí Remove.

Další informace o obaly COM objekt ActiveX hostování a interoperability primární sestavení viz Tlbimp.exe (Type Library Importer) a Aximp.exe (Windows Forms ActiveX Control Importer).

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

Viz také

Odkaz

References Rozhraní

VSLangProj – obor názvů