References.AddActiveX(String, Int32, Int32, Int32, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt einen Verweis auf eine ActiveX-Typbibliothek hinzu.
VSLangProj::Reference AddActiveX(std::wstring const & bstrTypeLibGuid, int lMajorVer = 0, int lMinorVer = 0, int lLocaleId = 0, std::wstring const & bstrWrapperTool = "");
[System.Runtime.InteropServices.DispId(7)]
public VSLangProj.Reference AddActiveX (string bstrTypeLibGuid, int lMajorVer = 0, int lMinorVer = 0, int lLocaleId = 0, string bstrWrapperTool = "");
[<System.Runtime.InteropServices.DispId(7)>]
abstract member AddActiveX : string * int * int * int * string -> VSLangProj.Reference
Public Function AddActiveX (bstrTypeLibGuid As String, Optional lMajorVer As Integer = 0, Optional lMinorVer As Integer = 0, Optional lLocaleId As Integer = 0, Optional bstrWrapperTool As String = "") As Reference
Parameter
- bstrTypeLibGuid
- String
Erforderlich. Die Globally Unique Identifier (GUID) der Typbibliothek, ausgedrückt als Zeichenfolge.
- lMajorVer
- Int32
(Optional) Die Hauptversionsnummer. Wenn der Wert nicht weggelassen wird, wird 0 verwendet.
- lMinorVer
- Int32
(Optional) Die Nebenversionsnummer. Wenn der Wert nicht weggelassen wird, wird 0 verwendet.
- bstrWrapperTool
- String
Das Wrapper Tool, das beim Erstellen eines Assemblywrappers für die Typbibliothek verwendet werden soll. Die unterstützten Werte werden in der folgenden Tabelle beschrieben. [1 | 1] Wert [1 | 2] Ergebnis [2 | 1] "Tlbimp" [2 | 2] das Projekt System generiert einen generischen Wrapper, der für den Zugriff auf die Methoden und Eigenschaften des COM-Objekts geeignet ist. [3 | 1] "Aximp" [3 | 2] das Projekt System generiert einen Wrapper, den Windows Forms für das ActiveX-Hosting verwendet. [4 | 1] "" (leere Zeichenfolge) [4 | 2] das Projekt System überprüft, ob eine primäre Interoperabilitäts-Assembly für die angegebene Typbibliothek vorhanden ist. Wenn Sie gefunden wird, wird diese Assembly als Wrapper für die Methoden und Eigenschaften des COM-Objekts verwendet. Wenn nicht gefunden, ist das Verhalten identisch mit dem Angeben von "Tlbimp".
Gibt zurück
Gibt ein- Reference Objekt für das angeforderte ActiveX-Bibliotheksobjekt zurück.
- Attribute
Beispiele
' 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
Hinweise
Die AddActiveX -Methode fügt Verweise auf ein Projekt für das angegebene Objekt und alle Abhängigkeiten hinzu, die vom-Objekt aufgelistet werden. Daher kann ein aufrufungs Vorgang dazu führen, dass der Auflistung mehr als ein Verweis hinzugefügt wird References .
Das gültige Format für eine GUID ist "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", wobei "X" eine hexadezimale Ziffer ist (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, B, C, D, E, F). Eine Methode zum Ermitteln der GUID für ein ActiveX-Objekt besteht darin, die OCX-oder TLB-Datei mithilfe des Oleview.exe Tools anzuzeigen, das mit Visual Studio verteilt ist.
Ein Fehler wird generiert, wenn ein Verweis mit der gleichen Identität bereits in der Auflistung vorhanden ist.
Wenn beim Verweisen auf ein gültiges COM-Objekt der Fehler "Bibliothek nicht registriert" angezeigt wird, liegt dies wahrscheinlich daran, dass Sie keinen gültigen lMajorVer Parameterwert an die- AddActiveX Methode übergeben. In der Standardeinstellung AddActiveX verwendet den Wert 0 für alles außer der GUID. Wenn die Version des COM-Objekts z. b. 1 lautet, schlägt der-Befehl fehl, da keine registrierte Version 0 des TypeLib vorhanden ist. Beispielsweise beim Aufrufen von Version 1,0 von Windows Media Player
ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}")
erzeugt den oben erwähnten Fehler, aber
ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}", 1)
funktioniert ordnungsgemäß.
Mit dieser Methode wird nur eine registrierte Typbibliothek hinzugefügt. An eine QueryPathOfRegTypeLib Automation-API-Funktion (früher OLE-Automatisierung) wird aufgerufen, und die an die-Methode bereitgestellten Informationen werden übergeben AddActiveX .
Wenn der Dateiname des ActiveX-Objekts bekannt ist, kann das-Objekt mit dem hinzugefügt werden Add . Die- Add Methode erfordert nicht die GUID, die Version oder die Gebiets Schema-ID.
Um einen Verweis zu entfernen, verwenden Sie Remove .
Weitere Informationen zu COM-Objekt-Wrapper, ActiveX-Hosting und primären Interoperabilitäts-Assemblys finden Sie unter Tlbimp.exe (Typbibliotheks-Import Programm) und Aximp.exe (Windows Forms ActiveX-Steuerelement Import).