Condividi tramite

Metodo References.AddActiveX

  • Articolo

Consente di aggiungere un riferimento a una libreria dei tipi ActiveX.

Spazio dei nomi:  VSLangProj
Assembly:  VSLangProj (in VSLangProj.dll)

Sintassi

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

Parametri

  • bstrTypeLibGuid
    Tipo: System.String
    Obbligatoria.Identificatore univoco globale (GUID) della libreria dei tipi, espresso come stringa.
  • lMajorVer
    Tipo: System.Int32
    Facoltativo.Il numero di versione principale.Se omesso, viene utilizzato 0.
  • lMinorVer
    Tipo: System.Int32
    Facoltativo.Il numero di versione secondario.Se omesso, viene utilizzato 0.
  • bstrWrapperTool
    Tipo: System.String
    Lo strumento wrapper da utilizzare quando viene generato un assembly wrapper per la libreria dei tipi.Nella tabella riportata di seguito viene fornita una descrizione dei valori supportati.
    [1|1] Valore
    [1|2] Risultato
    [2|1] "tlbimp"
    [2|2] Il sistema del progetto genera un wrapper generico utilizzabile per accedere alle proprietà e ai metodi dell'oggetto COM.
    [3|1] "aximp"
    [3|2] Il sistema del progetto genera un wrapper utilizzato da Windows Form per l'hosting di ActiveX.
    [4|1] "" (stringa vuota)
    [4|2] Il sistema del progetto verifica l'esistenza di un assembly di interoperabilità primario per la libreria dei tipi specificata.L'assembly eventualmente trovato viene utilizzato come wrapper per i metodi e le proprietà dell'oggetto COM.Se l'assembly non viene trovato, il comportamento corrisponde a quello determinato da "tlbimp" .

Valore restituito

Tipo: VSLangProj.Reference
Restituisce un oggetto Reference per l'oggetto libreria ActiveX richiesto.

Note

Il metodo AddActiveX aggiunge a un progetto i riferimenti per un oggetto specificato e le dipendenze elencate dall'oggetto. Una chiamata al metodo può pertanto determinare l'aggiunta all'insieme References di più riferimenti.

Il formato valido di un GUID corrisponde a {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, dove X è una cifra esadecimale (0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F). Per determinare il GUID per un oggetto ActiveX, è possibile visualizzare il file OCX o TLB utilizzando lo strumento Oleview.exe distribuito con Visual Studio.

Se nell'insieme è incluso un riferimento con la stessa identità, verrà generato un errore.

Un errore che indica una libreria non registrata, quando viene fatto riferimento a un oggetto COM valido, è in genere dovuto al mancato passaggio di un valore valido per il parametro lMajorVer al metodo AddActiveX. Per impostazione predefinita, il metodo AddActiveX utilizza un valore pari a 0 per tutto tranne che per il GUID. Se ad esempio la versione dell'oggetto COM è 1, la chiamata avrà esito negativo in quanto non esiste una versione 0 registrata nella libreria dei tipi. Durante la chiamata della versione 1.0 di Windows Media Player, ad esempio,

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

produce l'errore citato in precedenza, ma

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

funziona correttamente.

Il metodo aggiunge esclusivamente librerie dei tipi registrati. Viene effettuata una chiamata a QueryPathOfRegTypeLib, una funzione di automazione API (in precedenza di automazione OLE), con cui le informazioni fornite vengono passate al metodo AddActiveX.

Se il nome del file dell'oggetto ActiveX è noto, l'oggetto potrà essere aggiunto utilizzando il metodo Add. Il metodo Add non richiede il GUID, la versione o l'ID impostazioni locali.

Per rimuovere un riferimento, utilizzare Remove.

Per ulteriori informazioni sui wrapper per gli oggetti COM, l'hosting di ActiveX e gli assembly di interoperabilità primari, vedere Tlbimp.exe (utilità di importazione della libreria dei tipi) e Aximp.exe (utilità di importazione di controlli ActiveX di Windows Form).

Esempi

' 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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

References Interfaccia

Spazio dei nomi VSLangProj