Metodo Package.GetAutomationObject

Articolo
10/30/2012

Ottiene l'oggetto ActiveX per il package VS.

Spazio dei nomi: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)

Sintassi

'Dichiarazione
Protected Overridable Function GetAutomationObject ( _
    name As String _
) As Object

protected virtual Object GetAutomationObject(
    string name
)

Parametri

name
Tipo: System.String
Il nome dell'oggetto ActiveX da restituire.Se name è nullriferimento null (Nothing in Visual Basic), GetAutomationObject restituisce l'oggetto ActiveX predefinito per il package VS.

Valore restituito

Tipo: System.Object
Un'istanza dell'oggetto ActiveX, o nullriferimento null (Nothing in Visual Basic) se nessun supporto di automazione disponibile.

Eccezioni

Eccezione	Condizione
NotImplementedException	Generato dall'implementazione di base di GetAutomationObject.

Note

Eseguire l'override di GetAutomationObject quando il package VS estende il modello a oggetti di automazione DTE.

Il metodo di GetAutomationObject restituisce nullriferimento null (Nothing in Visual Basic) se name è nullriferimento null (Nothing in Visual Basic), che indica l'assenza di un oggetto ActiveX predefinito.In questo modo l'implementazione di IVsPackage a restituire E_NOTIMPL).

Se name non è nullriferimento null (Nothing in Visual Basic), la ricerca di questo metodo con gli attributi dei metadati disponibili per una pagina di opzione con un nome che corrisponde al formato <categoria> . <nome> .Se la pagina di opzione ha tale nome e indica che supporta l'automazione, l'oggetto ActiveX nella pagina di opzione viene restituito.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.