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
- 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.