Udostępnij za pośrednictwem

Metoda References.AddActiveX —

  • Artykuł

Dodaje odwołanie do biblioteki typów ActiveX.

Przestrzeń nazw:  VSLangProj
Zestaw:  VSLangProj (w VSLangProj.dll)

Składnia

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

    Wymagane.Biblioteka typów unikatowy identyfikator globalny (GUID), wyrażone jako ciąg znaków.

  • lMajorVer
    Typ: Int32

    Opcjonalne.Główny numer wersji.Jeśli argument jest pominięty, używana jest 0.

  • lMinorVer
    Typ: Int32

    Opcjonalne.Pomocniczy numer wersji.Jeśli argument jest pominięty, używana jest 0.

  • lLocaleId
    Typ: Int32

    Identyfikator ustawień regionalnych opcjonalne.Aby uzyskać więcej informacji, zobacz LocaleID.

  • bstrWrapperTool
    Typ: String

    Narzędzia otoki ma być używane podczas generowania otoki zestawu dla biblioteki typów.Obsługiwane wartości są opisane w poniższej tabeli.

    [1|1] Wartość

    [1|2] Wynik

    [2|1] "tlbimp"

    [2|2] Project system generuje rodzajowy otoki, nadające się do uzyskiwania dostępu do metod i właściwości obiektu COM.

    [3|1] "aximp"

    [3|2] Project system generuje otoki, że formularze systemu Windows używa do obsługi ActiveX.

    [4|1] "" (pusty ciąg)

    [4|2] System projektu sprawdza, czy istnieje zestawu podstawowego interoperacyjności dla biblioteki typów określonej.Jeśli znaleziono, następnie zespół ten jest używany jako otoka dla metody i właściwości obiektu COM.Jeśli nie znaleziono, zachowanie jest takie same jak gdyby "tlbimp" zostały określone.

Wartość zwracana

Typ: VSLangProj.Reference
Zwraca Reference obiekt do żądanego obiektu ActiveX w bibliotece.

Uwagi

AddActiveX Metoda dodaje odwołania do projektu dla określonego obiektu i wszelkie zależności wymienionych przez obiekt.W związku z tym, jedno wywołanie tej metody może spowodować więcej niż jedno odwołanie do References kolekcji.

Nieprawidłowy format identyfikatora GUID jest "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}", gdzie x jest cyfrą szesnastkową (0,1,2,3,4,5,6,7,8,9, A, B, C, D, E, F).Jedną z metod określania identyfikatora GUID dla obiektu ActiveX jest do wyświetlenia pliku ocx lub .tlb za pomocą narzędzia odpowiednim rozpowszechniane z programu Visual Studio.

Jeśli odwołanie o tej samej tożsamości jest już w kolekcji, zostanie wygenerowany błąd.

Jeśli komunikat o błędzie "Nie zarejestrowany biblioteki" podczas odwoływania się do prawidłowy obiekt COM, a następnie jest prawdopodobne, ze względu na fakt, że nie są przekazując prawidłowy lMajorVer wartość parametru AddActiveX metody.Domyślnie AddActiveX używa wartości 0 dla wszystkiego z wyjątkiem identyfikatora GUID.W przypadku wersji obiektu COM, na przykład 1, wywołanie nie powiedzie się, ponieważ nie jest zarejestrowanych wersja 0 z sekcji typelib.Na przykład podczas wywoływania programu Windows Media player w wersji 1.0

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

powoduje błąd wyżej wymienione, ale

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

działa poprawnie.

Ta metoda spowoduje dodanie tylko zarejestrowany typ biblioteki.Wywołanie QueryPathOfRegTypeLib, funkcję API automatyzacji (dawniej automatyzacji OLE), przekazując informacje dostarczone do AddActiveX metody.

Jeśli znana jest nazwa pliku obiektu ActiveX, obiektu mogą być dodawane za pomocą Add.Add Metoda nie wymaga identyfikatora GUID, wersji i ustawień regionalnych.

Aby usunąć odwołanie, użyj Remove.

Więcej informacji dotyczących otoki obiektów COM, ActiveX hosting i zespoły interoperacyjności podstawowy, zobacz Tlbimp.exe (Importer biblioteki typów) i Aximp.exe (Importer kontrolki ActiveX formularzy systemu Windows).

Przykłady

' 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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

References Interfejs

Przestrzeń nazw VSLangProj