AsyncPackage Classe

Definizione

Spazio dei nomi:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Pacchetto:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Rappresenta un VSPackage in grado di gestire i servizi asincroni.

public ref class AsyncPackage abstract : Microsoft::VisualStudio::Shell::Package, Microsoft::VisualStudio::Shell::IAsyncServiceContainer, Microsoft::VisualStudio::Shell::IAsyncServiceProvider2, Microsoft::VisualStudio::Shell::Interop::COMAsyncServiceProvider::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::Interop::IAsyncLoadablePackageInitialize, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactoryProvider

[Windows::Foundation::Metadata::WebHostHidden]
public ref class AsyncPackage abstract : Microsoft::VisualStudio::Shell::Package, Microsoft::VisualStudio::Shell::IAsyncServiceContainer, Microsoft::VisualStudio::Shell::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::IAsyncServiceProvider2, Microsoft::VisualStudio::Shell::Interop::IAsyncLoadablePackageInitialize, Microsoft::VisualStudio::Shell::Interop::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactoryProvider

[Windows::Foundation::Metadata::WebHostHidden]
class AsyncPackage abstract : Microsoft::VisualStudio::Shell::Package, Microsoft::VisualStudio::Shell::IAsyncServiceContainer, Microsoft::VisualStudio::Shell::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::IAsyncServiceProvider2, Microsoft::VisualStudio::Shell::Interop::IAsyncLoadablePackageInitialize, Microsoft::VisualStudio::Shell::Interop::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsAsyncToolWindowFactoryProvider

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class AsyncPackage : Microsoft.VisualStudio.Shell.Package, Microsoft.VisualStudio.Shell.IAsyncServiceContainer, Microsoft.VisualStudio.Shell.IAsyncServiceProvider2, Microsoft.VisualStudio.Shell.Interop.COMAsyncServiceProvider.IAsyncServiceProvider, Microsoft.VisualStudio.Shell.Interop.IAsyncLoadablePackageInitialize, Microsoft.VisualStudio.Shell.Interop.IVsAsyncToolWindowFactory, Microsoft.VisualStudio.Shell.Interop.IVsAsyncToolWindowFactoryProvider

[<System.Runtime.InteropServices.ComVisible(true)>]
type AsyncPackage = class
    inherit Package
    interface IAsyncServiceProvider
    interface IAsyncLoadablePackageInitialize
    interface IAsyncServiceProvider2
    interface IAsyncServiceProvider
    interface IAsyncServiceContainer
    interface IVsAsyncToolWindowFactory
    interface IVsAsyncToolWindowFactoryProvider

Public MustInherit Class AsyncPackage
Inherits Package
Implements IAsyncLoadablePackageInitialize, IAsyncServiceContainer, IAsyncServiceProvider, IAsyncServiceProvider2, IVsAsyncToolWindowFactory, IVsAsyncToolWindowFactoryProvider

Ereditarietà

Object

Package

AsyncPackage

Derivato

Microsoft.VisualStudio.Modeling.Shell.AsyncModelingPackage

Microsoft.VisualStudio.Shell.ExtensionPointAsyncPackage

Attributi

ComVisibleAttribute

Implementazioni

IAsyncServiceContainer IAsyncServiceProvider IAsyncLoadablePackageInitialize IAsyncServiceProvider2 IVsAsyncToolWindowFactory IVsAsyncToolWindowFactoryProvider Microsoft.VisualStudio.Shell.Interop.COMAsyncServiceProvider.IAsyncServiceProvider

Costruttori

AsyncPackage()

Costruttore predefinito AsyncPackage.

Proprietà

ApplicationRegistryRoot	Ottiene la chiave del Registro di sistema radice dell'hive corrente del Registro di sistema di Visual Studio. (Ereditato da Package)
DisposalToken	Espone un CancellationToken oggetto che può essere utilizzato per verificare se il pacchetto è stato eliminato. Questa situazione può verificarsi per le attività asincrone in esecuzione in un thread in background quando Visual Studio ha avviato l'arresto. Usare ShutdownToken per un'indicazione precedente che VISUAL Studio sta arrestando.
JoinableTaskCollection	Ottiene la raccolta di attività asincrone avviate da questo pacchetto.
JoinableTaskFactory	Ottiene la factory da utilizzare per le attività asincrone avviate da questo pacchetto.
UserDataPath	Ottiene il percorso dell'archivio dati utente per Visual Studio. (Ereditato da Package)
UserLocalDataPath	Ottiene il percorso dell'archivio dati utente locale per Visual Studio. (Ereditato da Package)
UserRegistryRoot	Ottiene una chiave del Registro di sistema che può essere utilizzata per archiviare i dati utente. (Ereditato da Package)
Zombied	Ottiene un valore che indica se è in corso la chiusura del package. (Ereditato da Package)

Metodi

AddOptionKey(String)	Aggiunge un nome della chiave di opzione utente all'elenco di chiavi di opzione. (Ereditato da Package)
AddService(Type, AsyncServiceCreatorCallback)	Aggiunge un servizio asincrono a questo pacchetto. Questo servizio non sarà visibile all'esterno di questo pacchetto.
AddService(Type, AsyncServiceCreatorCallback, Boolean)	Aggiunge un servizio asincrono a questo pacchetto. Questo servizio può essere o meno visibile all'esterno di questo pacchetto, a seconda del valore di promote.
AddService(Type, AsyncServiceCreatorWithProgressCallback)	Aggiunge un servizio asincrono a questo pacchetto che supporta gli aggiornamenti dello stato di avanzamento durante l'inizializzazione. Questo servizio non sarà visibile all'esterno di questo pacchetto.
AddService(Type, AsyncServiceCreatorWithProgressCallback, Boolean)	Aggiunge un servizio asincrono a questo pacchetto che supporta gli aggiornamenti dello stato di avanzamento durante l'inizializzazione. Questo servizio può essere o meno visibile all'esterno di questo pacchetto, a seconda del valore di promote.
CreateInstance(Guid, Guid, Type)	Crea l'oggetto COM specificato usando l'oggetto CLSID del Registro di sistema locale di Visual Studio. (Ereditato da Package)
CreateTool(Guid)	Consente alle classi derivate di fornire un'implementazione se necessario. (Ereditato da Package)
CreateToolWindow(Guid, Int32)	Crea una finestra degli strumenti del tipo specificato con l'ID specificato. (Ereditato da Package)
CreateToolWindow(Type, Int32)	Crea una finestra degli strumenti del tipo specificato con l'ID specificato. (Ereditato da Package)
CreateToolWindow(Type, Int32, Object)	Create una finestra degli strumenti del tipo specificato con l'ID specificato. (Ereditato da Package)
CreateToolWindow(Type, Int32, UInt32)	Crea una finestra degli strumenti del tipo specificato con l'ID specificato. (Ereditato da Package)
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Create una finestra degli strumenti del tipo specificato con l'ID specificato. Questo è l'unico metodo che deve chiamare IVsUiShell.CreateToolWindow() (Ereditato da Package)
Dispose(Boolean)	Elimina l'oggetto e il token di annullamento associato.
FindToolWindow(Type, Int32, Boolean)	Ottiene la finestra degli strumenti corrispondente al tipo e all'ID specificati. (Ereditato da Package)
FindToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Individua in modo asincrono la finestra degli strumenti corrispondente al tipo e all'ID specificati. Se non esiste, crea e restituisce uno se create è true oppure restituisce Null se create è false.
FindWindowPane(Type, Int32, Boolean)	Ottiene il riquadro della finestra che corrisponde al tipo e all'ID specificati e se nessun riquadro della finestra di quel tipo esiste ne crea uno, se richiesto. (Ereditato da Package)
FindWindowPaneAsync(Type, Int32, Boolean, CancellationToken)	Individua in modo asincrono il riquadro della finestra corrispondente al tipo e all'ID specificati. Se non esiste, crea e restituisce uno se create è true oppure restituisce Null se create è false.
GetAsyncToolWindowFactory(Guid)	Restituisce l'interfaccia factory della finestra degli strumenti asincrona per la finestra degli strumenti identificata da toolWindowType, se la creazione asincrona è supportata per la finestra degli strumenti. Se la creazione asincrona non è supportata, viene restituito Null.
GetAutomationObject(String)	Ottiene l'oggetto di automazione per il package VS. (Ereditato da Package)
GetDialogPage(Type)	Ottiene la pagina della finestra di dialogo richiesta. (Ereditato da Package)
GetOutputPane(Guid, String)	Ottiene la finestra di output richiesta. (Ereditato da Package)
GetProviderLocale()	Restituisce le impostazioni locali associate al provider di servizi. (Ereditato da Package)
GetService(Type)	Recupera un servizio registrato con questo pacchetto. Questo metodo è sincrono e anche i servizi asincroni recuperati in questo modo verranno recuperati in modo sincrono.
GetServiceAsync(Type)	Recupera un servizio asincrono.
GetServiceAsync(Type, Boolean)	Recupera un servizio asincrono, ma consente al chiamante di suggerire che le eccezioni potrebbero non dover essere inghiottite. Non garantisce che vengano generate eccezioni, tuttavia per i casi di errore.
GetToolboxItemData(String, DataFormats+Format)	Ottiene il contenuto del formato dati per l'ID dell'elemento della casella degli strumenti e il formato dati specificati. (Ereditato da Package)
GetToolboxItemDataAsync(String, DataFormats+Format)	Rappresenta un VSPackage in grado di gestire i servizi asincroni. (Ereditato da Package)
GetToolWindowTitle(Type, Int32)	Restituisce la stringa del titolo da utilizzare per la finestra degli strumenti. Se viene restituito Null, il nome del tipo della finestra degli strumenti viene usato per il titolo.
Initialize()	Bloccare questo metodo. A causa di un rischio quasi inevitabile di deadlock, SetSite (che è ciò che chiama Initialize) si verifica ancora nel thread dell'interfaccia utente anche per il pacchetto asincrono. Poiché la maggior parte degli autori di pacchetti asincroni avrebbe, logicamente, presupporre che l'inizializzazione avviene su un thread b/g che potrebbero eseguire operazioni costose (sincrone) all'interno dell'override, sconfiggendo alcuni dei vantaggi dei caricamenti asincroni. Per aiutarli a evitare che lo sigilleremo e quindi tutto ciò che possono eseguire l'override è l'inizializzazione asincrona, che viene chiamata sul thread b/g.
InitializeAsync(CancellationToken, IProgress<ServiceProgressData>)	Parte di inizializzazione asincrona del processo di inizializzazione del pacchetto. Questo metodo viene richiamato da un thread in background.
InitializeToolWindowAsync(Type, Int32, CancellationToken)	Esegue l'inizializzazione in preparazione per la creazione della finestra degli strumenti identificata da toolWindowType.
InstantiateToolWindow(Type)	Rappresenta un VSPackage in grado di gestire i servizi asincroni. (Ereditato da Package)
InstantiateToolWindow(Type, Object)	Costruire una finestra degli strumenti del tipo specificato. (Ereditato da Package)
IsLocalService(Type)	Determina se il tipo di servizio specificato può essere recuperato senza richiedere una transizione RPC al thread dell'interfaccia utente. (Ereditato da Package)
OnAfterPackageLoadedAsync(CancellationToken)	Quando ne viene eseguito l'override da un tipo derivato, può avviare operazioni con effetti collaterali che non sono strettamente parte del caricamento del pacchetto che appartenerebbero, InitializeAsync(CancellationToken, IProgress<ServiceProgressData>) ma che dovrebbero verificarsi subito dopo il caricamento del pacchetto (ad esempio, l'aggiornamento dello stato del comando).
OnLoadOptions(String, Stream)	Richiamato dalla classe del pacchetto quando esistono opzioni da leggere nel file della soluzione. (Ereditato da Package)
OnSaveOptions(String, Stream)	Richiamato dalla classe Package quando esistono opzioni da salvare nel file della soluzione. (Ereditato da Package)
ParseToolboxResource(TextReader, Guid)	Analizza una risorsa di testo incorporata di formato appropriato per informazioni sugli elementi da aggiungere alla casella degli strumenti. (Ereditato da Package)
ParseToolboxResource(TextReader, ResourceManager)	Analizza una risorsa di testo incorporata di formato appropriato per informazioni sugli elementi da aggiungere alla casella degli strumenti. (Ereditato da Package)
QueryClose(Boolean)	Chiamato per chiedere il pacchetto se la shell può essere chiusa. (Ereditato da Package)
RegisterEditorFactory(IVsEditorFactory)	Registra una factory dell'editor con Visual Studio. (Ereditato da Package)
RegisterProjectFactory(IVsProjectFactory)	Registra una factory progetto in Visual Studio. (Ereditato da Package)
RemoveService(Type)	Rimuove un servizio asincrono registrato con questo pacchetto.
RemoveService(Type, Boolean)	Rimuove un servizio asincrono registrato con questo pacchetto.
ShowOptionPage(Type)	Visualizza una pagina di opzioni degli strumenti specificata. (Ereditato da Package)
ShowToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Mostra in modo asincrono la finestra degli strumenti corrispondente al tipo e all'ID specificati. Se non esiste, crea e restituisce uno se create è true oppure restituisce Null se create è false.

Eventi

ToolboxInitialized	Evento generato ogni volta che Visual Studio inizializza la casella degli strumenti. (Ereditato da Package)
ToolboxUpgraded	Evento generato ogni volta che Visual Studio aggiorna la casella degli strumenti. (Ereditato da Package)

Implementazioni dell'interfaccia esplicita

IAsyncLoadablePackageInitialize.Initialize(IAsyncServiceProvider, IProfferAsyncService, IAsyncProgressCallback)	Versione asincrona di SetSite, chiamata da un thread b/g.
IAsyncServiceProvider.QueryServiceAsync(Guid)	Ottenere un servizio di inizializzazione asincrona offerto da questo pacchetto.
IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Esegue un comando specificato o visualizza la Guida per un comando. (Ereditato da Package)
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Esegue una query sull'oggetto per lo stato di uno o più comandi generati dagli eventi dell'interfaccia utente. (Ereditato da Package)
IServiceContainer.AddService(Type, Object)	Aggiunge il servizio specificato al contenitore di servizio del pacchetto VSPackage. (Ereditato da Package)
IServiceContainer.AddService(Type, Object, Boolean)	Aggiunge il servizio specificato al contenitore di servizio del pacchetto VSPackage. (Ereditato da Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Aggiunge il servizio specificato al contenitore di servizio del pacchetto VSPackage. (Ereditato da Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Aggiunge il servizio specificato al contenitore di servizi tramite l'elemento ServiceCreatorCallback specificato. (Ereditato da Package)
IServiceContainer.RemoveService(Type)	Rimuove il tipo di servizio specificato dal contenitore dei servizi. (Ereditato da Package)
IServiceContainer.RemoveService(Type, Boolean)	Rimuove il tipo di servizio specificato dal contenitore dei servizi e facoltativamente promuove la rimozione del servizio ai contenitori dei servizi padre. (Ereditato da Package)
IServiceProvider.GetService(Type)	Ottiene il servizio del tipo specificato. (Ereditato da Package)
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Implementazione interna di IServiceProvider. (Ereditato da Package)
IVsAsyncToolWindowFactory.CreateToolWindow(Guid, UInt32, Object)	Crea una finestra degli strumenti del tipo specificato con l'ID specificato.
IVsAsyncToolWindowFactory.GetToolWindowTitle(Guid, UInt32)	Restituisce la stringa del titolo da utilizzare per la finestra degli strumenti. Se viene restituito Null, il nome del tipo della finestra degli strumenti viene usato per il titolo.
IVsAsyncToolWindowFactory.InitializeToolWindowAsync(Guid, UInt32)	Esegue l'inizializzazione in preparazione per la creazione della finestra degli strumenti identificata da toolWindowType.
IVsPackage.Close()	Chiude ed elimina il pacchetto. (Ereditato da Package)
IVsPackage.GetAutomationObject(String, Object)	Ottiene un oggetto adatto all'automazione per questo pacchetto. (Ereditato da Package)
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Consente di accedere al menu Strumenti Opzioni e alle pagine delle proprietà delle finestre di dialogo Personalizza casella degli strumenti. (Ereditato da Package)
IVsPackage.QueryClose(Int32)	Chiamato per chiedere al VSPackage se la shell di Visual Studio può essere chiusa. (Ereditato da Package)
IVsPackage.ResetDefaults(UInt32)	Reimposta le impostazioni predefinite della Casella degli strumenti. (Ereditato da Package)
IVsPackage.SetSite(IServiceProvider)	Inizializza il VSPackage nell'ambiente di Visual Studio. (Ereditato da Package)
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Carica le opzioni utente per una soluzione specificata. (Ereditato da Package)
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Legge le opzioni utente per una soluzione specificata. (Ereditato da Package)
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Salva le opzioni utente per una soluzione specificata. (Ereditato da Package)
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Scrive le opzioni utente per una soluzione specificata. (Ereditato da Package)
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Ottiene un elemento. (Ereditato da Package)
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)	Rappresenta un VSPackage in grado di gestire i servizi asincroni. (Ereditato da Package)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Crea una finestra degli strumenti del tipo specificato con l'ID specificato. (Ereditato da Package)
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Questo metodo implementa l'interfaccia IVsUserSettings utilizzata per gestire i profili e le impostazioni di importazione/esportazione nei file XML. (Ereditato da Package)
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Recupera la configurazione di un VSPackage usando il meccanismo delle impostazioni di Visual Studio quando un utente seleziona l'opzione di importazione della funzionalità Importa/Esporta impostazioni nel menu Strumenti dell'IDE. Questo metodo è parte dell'implementazione dell'interfaccia IVsUserSettings utilizzata per gestire i profili e le impostazioni di importazione/esportazione nei file XML. (Ereditato da Package)
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Esegue la migrazione di impostazioni da una versione precedente. (Ereditato da Package)
IVsUserSettingsQuery.NeedExport(String, Int32)	Determina se le impostazioni sono state modificate e devono essere esportate di nuovo. (Ereditato da Package)

Metodi di estensione

ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>)	Distribuisce un servizio implementato dal tipo specificato in un contenitore del servizio asincrono. Quando il servizio viene sottoposto a query la prima volta, la creator funzione verrà chiamata. Il servizio proffered verrà promosso al contenitore del servizio asincrono padre.
ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>, Boolean)	Distribuisce un servizio implementato dal tipo specificato in un contenitore del servizio asincrono. Quando il servizio viene sottoposto a query la prima volta, la creator funzione verrà chiamata.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>)	Distribuisce un servizio implementato dal tipo specificato in un contenitore del servizio asincrono. Quando il servizio viene sottoposto a query la prima volta, la creator funzione verrà chiamata. Il servizio proffered verrà promosso al contenitore del servizio asincrono padre.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>, Boolean)	Distribuisce un servizio implementato dal tipo specificato in un contenitore del servizio asincrono. Quando il servizio viene sottoposto a query la prima volta, la creator funzione verrà chiamata.
QueryService(IServiceProvider, Guid)	Ottiene un servizio esposto da un provider di servizi in base al GUID del servizio.
QueryService<TService>(IServiceProvider)	Ottiene un servizio esposto da un provider di servizi in base al tipo di servizio.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider)	Ottiene un'interfaccia del servizio da un provider di servizi in modo asincrono.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider, Boolean)	Ottiene un'interfaccia del servizio da un provider di servizi in modo asincrono.