Classe Package

Articolo
10/30/2012

Fornisce un'implementazione gestita delle interfacce obbligatorie per creare un oggetto completamente - VSPackage funzionale.

Gerarchia di ereditarietà

System.Object
Microsoft.VisualStudio.Shell.Package
Microsoft.VisualStudio.Shell.ExtensionPointPackage

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

Sintassi

'Dichiarazione
<ComVisibleAttribute(True)> _
<PackageRegistrationAttribute> _
Public MustInherit Class Package _
    Implements IVsPackage, IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts,  _
    IServiceContainer, IServiceProvider, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery,  _
    IVsToolWindowFactory, IVsToolboxItemProvider

[ComVisibleAttribute(true)]
[PackageRegistrationAttribute]
public abstract class Package : IVsPackage, 
    IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts, IServiceContainer, IServiceProvider, 
    IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery, IVsToolWindowFactory, IVsToolboxItemProvider

Il tipo Package espone i seguenti membri.

Costruttori

	Nome	Descrizione
	Package	inizializza una nuova istanza di Package.

In alto

Proprietà

	Nome	Descrizione
	ApplicationRegistryRoot	Ottiene la chiave del Registro di sistema radice dell'hive correnti di Visual Studio il Registro di sistema.
	UserDataPath	Ottiene il percorso di archiviazione dei dati utente per Visual Studio.
	UserLocalDataPath	Ottiene il percorso di archiviazione dei dati utente locale per Visual Studio.
	UserRegistryRoot	Ottiene una chiave del Registro di sistema che può essere utilizzata per archiviare i dati dell'utente.
	Zombied	Ottiene un valore che indica se il pacchetto nel corso dell'arresto.

In alto

Metodi

	Nome	Descrizione
	AddOptionKey	Aggiunge un nome della chiave delle opzioni utente nell'elenco delle chiavi di opzione.
	CreateInstance	Crea l'oggetto COM specificato utilizzando l'oggetto del Registro di sistema CLSID locali dei vsprvs.
	CreateTool	Consente alle classi derivate di fornire un'implementazione se necessario.
	CreateToolWindow	Crea una finestra degli strumenti del tipo specificato con l'id specificato
	Dispose	Liberare le risorse utilizzate dall'oggetto di Package .
	Equals	Determina se l'oggetto specificato equivale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	FindToolWindow	Ottiene la finestra degli strumenti che corrisponde al tipo e all'identificazione specificati
	FindWindowPane	Ottiene il riquadro che corrisponde al tipo e sull'ID specificati e se nessun riquadro di quel tipo esistente creato uno se dicesse a tale scopo.
	GetAutomationObject	Ottiene l'oggetto ActiveX per il package VS.
	GetDialogPage	Ottiene la pagina richiesta della finestra di dialogo.
	GetGlobalService	Ottiene un servizio fornito globalmente da Visual Studio o da uno dei pacchetti. Questa operazione equivale alla chiamata GetService() su un'istanza di un pacchetto che non offre servizi stesso.
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetOutputPane	ottiene la finestra di output richiesta.
	GetProviderLocale	Restituisce le impostazioni locali associate a questo provider di servizi.
	GetService	Ottiene i servizi basati su tipi dal contenitore del servizio di un VSPackage.
	GetToolboxItemData	Ottiene il contenuto del formato dati per l'elemento della casella degli strumenti ID specificato e il formato dati.
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	Initialize	Chiamato quando il package VS viene caricato da Visual Studio.
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnLoadOptions	Richiamato dalla classe del pacchetto quando esistono opzioni essere letta dal file della soluzione.
	OnSaveOptions	Richiamato dalla classe di Package quando sono presenti opzioni essere salvato nel file della soluzione.
	ParseToolboxResource(TextReader, Guid)	Analizza una risorsa incorporata del testo del formato appropriato per informazioni sui cui elementi devono essere aggiunte a Casella degli strumenti.
	ParseToolboxResource(TextReader, ResourceManager)	Analizza una risorsa incorporata del testo del formato appropriato per informazioni sui cui elementi devono essere aggiunte a Casella degli strumenti.
	QueryClose	Chiamato per chiedere il pacchetto se la shell può essere chiuso.
	RegisterEditorFactory	Registra una factory dell'editor con Visual Studio.
	RegisterProjectFactory	Registra una factory di progetto in Visual Studio.
	ShowOptionPage	Visualizzare una determinata pagina di opzioni degli strumenti.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

	Nome	Descrizione
	ToolboxInitialized	Evento generato ogni volta che Visual Studio inizializza il relativo Casella degli strumenti.
	ToolboxUpgraded	Evento generato ogni volta che Visual Studio aggiorna il relativo Casella degli strumenti.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IServiceContainer.AddService(Type, ServiceCreatorCallback)	Infrastruttura. Aggiunge il servizio specificato al contenitore del servizio del package VS.
	IServiceContainer.AddService(Type, Object)	Infrastruttura. Aggiunge il servizio specificato al contenitore del servizio del package VS.
	IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Aggiunge il servizio specificato al contenitore del servizio per l'utilizzo di ServiceCreatorCallbackspecificato.
	IServiceContainer.AddService(Type, Object, Boolean)	Infrastruttura. Aggiunge il servizio specificato al contenitore del servizio del package VS.
	IServiceProvider.GetService	Ottiene il servizio del tipo specificato.
	IServiceContainer.RemoveService(Type)	Infrastruttura. Rimuove il tipo di servizio specificato dal contenitore di servizio.
	IServiceContainer.RemoveService(Type, Boolean)	Infrastruttura. Rimuove il tipo di servizio specificato dal contenitore del servizio e facoltativamente facilita la rimozione del servizio ai contenitori padre del servizio.
	IOleCommandTarget.Exec	Esegue un comando specificato o consente di visualizzare per un comando.
	IOleCommandTarget.QueryStatus	Eseguire una query l'oggetto per lo stato di uno o più controlli generati dagli eventi dell'interfaccia utente.
	IServiceProvider.QueryService	Infrastruttura. L'implementazione interna di IServiceProvider .
	IVsPackage.Close	Infrastruttura. Chiudere ed elimina il pacchetto.
	IVsPackage.GetAutomationObject	Infrastruttura. Ottiene un oggetto automazione-semplice per questo pacchetto.
	IVsPackage.GetPropertyPage	Infrastruttura. I Proffers l'accesso a strumenti il menu opzioni le pagine delle proprietà e delle finestre di dialogo di Personalizzare la casella degli strumenti .
	IVsPackage.QueryClose	Infrastruttura. Chiamato per chiedere il package VS se la shell di Visual Studio può essere chiuso.
	IVsPackage.ResetDefaults	Infrastruttura. Impostazioni predefinite di Casella degli strumenti di reimpostato.
	IVsPackage.SetSite	Infrastruttura. Inizializza il package VS nell'ambiente di Visual Studio .
	IVsPersistSolutionOpts.LoadUserOptions	Infrastruttura. Carica le opzioni di una soluzione specificata.
	IVsPersistSolutionOpts.ReadUserOptions	Infrastruttura. Legge le opzioni di una soluzione specificata.
	IVsPersistSolutionOpts.SaveUserOptions	Infrastruttura. Salva le opzioni di una soluzione specificata.
	IVsPersistSolutionOpts.WriteUserOptions	Infrastruttura. Scrive le opzioni di una soluzione specificata.
	IVsToolboxItemProvider.GetItemContent	ottiene un elemento.
	IVsToolWindowFactory.CreateToolWindow	Infrastruttura. Crea una finestra degli strumenti del tipo specificato con l'id specificato
	IVsUserSettings.ExportSettings	Questo metodo implementa l'interfaccia di IVsUserSettings utilizzata per gestire i profili e importare/esporta impostazioni ai file XML.
	IVsUserSettings.ImportSettings	Recupera la configurazione di un package VS utilizzando il meccanismo delle impostazioni di Visual Studio quando un utente seleziona l'opzione di importazione della funzionalità di Impostazioni esportazione/importazione il menu strumenti dell'IDE.Questo metodo fa parte dell'implementazione dell'interfaccia di IVsUserSettings utilizzata per gestire i profili e importare/esporta impostazioni ai file XML.
	IVsUserSettingsMigration.MigrateSettings	Esegue la migrazione di impostazioni da una versione precedente.
	IVsUserSettingsQuery.NeedExport

In alto

Note

La classe di Package fornisce un'implementazione gestita di diverse interfacce di VSIP più utili.È possibile creare la funzionalità di base di un package VS con relativamente breve codice derivazione dalla classe di Package , eseguendo l'override di alcuni dei metodi e connettendo le classi di registrazione.La classe di Package non fornisce supporto diretto di registrazione, ma è possibile utilizzare le classi di attributi per fornire informazioni di registrazione necessarie agli strumenti esterni come RegPkg.exe.

La classe di Package fornisce i seguenti servizi per impostazione predefinita.(È possibile sostituirle richiesto il package VS IServiceContainer, rimuovendo loro e l'aggiunta di altri servizi nel loro posto.)

Package

Il pacchetto è disponibile come servizio.
IServiceContainer

Consente di aggiungere e rimuovere i servizi.Ogni servizio aggiunto con “è promuove„ impostato su true viene offerto a Visual Studio con IProfferService.In questo modo il servizio globale a un Vspackage all'interno di Visual Studio.(Questo servizio è disponibile solo se il package VS è già stato caricato.)

Oltre a questi servizi, Package utilizza l'architettura del servizio di Visual Studio per fornire l'accesso a qualsiasi servizio disponibili tramite il provider di servizi globale.