References.AddActiveX-Methode

Artikel
05/16/2015

Fügt einen Verweis auf die ActiveX-Typbibliothek ein.

Namespace: VSLangProj
Assembly: VSLangProj (in VSLangProj.dll)

Syntax

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

Parameter

bstrTypeLibGuid
Typ: String

Erforderlich. Die als Zeichenfolge ausgedrückte GUID (Globally Unique Identifier) der Typbibliothek.

lMajorVer
Typ: Int32

Optional. Die Hauptversionsnummer. Wird der Wert nicht angegeben, so wird 0 verwendet.

lMinorVer
Typ: Int32

Optional. Die Nebenversionsnummer. Wird der Wert nicht angegeben, so wird 0 verwendet.

lLocaleId
Typ: Int32

Optionale Gebietsschema-ID. Weitere Informationen finden Sie unter LocaleID.

bstrWrapperTool
Typ: String

Das Wrappertool, das beim Generieren eines Assemblywrappers für die Typbibliothek verwendet wird. Die unterstützten Werte werden in der folgenden Tabelle beschrieben.

[1|1] Wert

[1|2] Ergebnis

[2|1] "tlbimp"

[2|2] Das Projektsystem generiert einen generischen Wrapper, mit dem auf die Methoden und Eigenschaften des COM-Objekts zugegriffen werden kann.

[3|1] "aximp"

[3|2] Das Projektsystem generiert einen Wrapper, den Windows Forms zum ActiveX-Hosting verwenden.

[4|1] "" (leere Zeichenfolge)

[4|2] Das Projektsystem prüft, ob eine primäre Interoperatibilitäts-Assembly für die angegebene Typbibliothek vorhanden ist. Falls ja, wird diese Assembly als Wrapper für die Methoden und Eigenschaften des COM-Objekts verwendet. Falls keine gefunden wird, ist das Verhalten so wie beim Wert "tlbimp" .

Rückgabewert

Typ: VSLangProj.Reference
Gibt ein Reference-Objekt für das angeforderte ActiveX-Bibliotheksobjekt zurück.

Hinweise

Die AddActiveX-Methode fügt einem Projekt Verweise auf das angegebene Objekt und alle vom Objekt aufgeführten Abhängigkeiten hinzu. Daher kann ein Aufruf dieser Methode dazu führen, dass der References-Auflistung mehrere Verweise hinzugefügt werden.

Das gültige Format für eine GUID ist "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}", wobei X eine Hexadezimalzahl ist (0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F). Wenn Sie die GUID für ein ActiveX-Objekt bestimmen möchten, können Sie beispielsweise die OCX- oder TLB-Datei mithilfe des in Visual Studio integrierten Tools Oleview.exe anzeigen.

Ein Fehler wird generiert, wenn in der Auflistung bereits ein Verweis mit derselben Identität vorhanden ist.

Wenn Sie bei einem Verweis auf ein gültiges COM-Objekt die Fehlermeldung "Bibliothek nicht registriert" erhalten, ist dies wahrscheinlich darauf zurückzuführen, dass Sie keinen gültigen lMajorVer-Parameterwert an die AddActiveX-Methode übergeben. Außer für die GUID verwendet AddActiveX standardmäßig einen Wert von 0. Wenn die Version des COM-Objekts beispielsweise 1 ist, schlägt der Aufruf fehl, da keine registrierte Version 0 von typelib vorhanden ist. Beim Aufrufen der Version 1.0 von Windows Media Player

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

wird beispielsweise der oben angegebene Fehler generiert,

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

funktioniert jedoch ordnungsgemäß.

Mit dieser Methode kann nur eine registrierte Typbibliothek hinzugefügt werden. QueryPathOfRegTypeLib wird aufgerufen. Dies ist eine Automatisierungs-API-Funktion (früher OLE-Automatisierung), die die erhaltenen Informationen an die AddActiveX-Methode übergibt.

Wenn der Dateiname des ActiveX-Objekts bekannt ist, kann das Objekt mit der Add-Methode hinzugefügt werden. Für die Add-Methode sind GUID, Version und Gebietsschema-ID nicht erforderlich.

Um einen Verweis zu entfernen, verwenden Sie Remove.

Weitere Informationen zu COM-Objektwrapper, ActiveX-Hosting und primären Interoperabilitätsassemblys finden Sie unter Tlbimp.exe (Type Library Importer-Tool) und Aximp.exe (Windows Forms ActiveX Control Importer-Tool).

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

References Schnittstelle

VSLangProj-Namespace

Freigeben über