AsyncPackage Třída

Definice

Obor názvů:

Microsoft.VisualStudio.Shell

Sestavení:

Microsoft.VisualStudio.Shell.15.0.dll

Balíček:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Představuje balíček VSPackage, který může zpracovávat asynchronní služby.

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

Dědičnost

Object

Package

AsyncPackage

Odvozené

Microsoft.VisualStudio.Modeling.Shell.AsyncModelingPackage

Microsoft.VisualStudio.Shell.ExtensionPointAsyncPackage

Atributy

ComVisibleAttribute

Implementuje

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

Konstruktory

AsyncPackage()

Výchozí konstruktor AsyncPackage.

Vlastnosti

ApplicationRegistryRoot	Získá kořenový klíč registru aktuálního podregistru registru sady Visual Studio. (Zděděno od Package)
DisposalToken	CancellationToken Zveřejňuje objekt, který lze použít ke kontrole, jestli byl balíček odstraněn. K tomu může dojít u asynchronních úloh spuštěných ve vlákně na pozadí, když se sada Visual Studio začala vypínat. Použijte ShutdownToken pro dřívější indikaci, že se sada VS vypíná.
JoinableTaskCollection	Získá kolekci asynchronních úloh zahájených tímto balíčkem.
JoinableTaskFactory	Získá objekt pro použití pro asynchronní úlohy zahájené tímto balíčkem.
UserDataPath	Získá cestu k úložišti dat uživatele pro Visual Studio. (Zděděno od Package)
UserLocalDataPath	Získá cestu k místnímu úložišti dat uživatele pro Visual Studio. (Zděděno od Package)
UserRegistryRoot	Získá klíč registru, který lze použít k ukládání dat uživatele. (Zděděno od Package)
Zombied	Získá hodnotu označující, zda balíček v procesu vypnutí. (Zděděno od Package)

Metody

AddOptionKey(String)	Přidá název klíče možnosti uživatele do seznamu klíčů možností. (Zděděno od Package)
AddService(Type, AsyncServiceCreatorCallback)	Přidá do tohoto balíčku asynchronní službu. Tato služba nebude viditelná mimo tento balíček.
AddService(Type, AsyncServiceCreatorCallback, Boolean)	Přidá do tohoto balíčku asynchronní službu. Tato služba může nebo nemusí být viditelná mimo tento balíček v závislosti na hodnotě .promote
AddService(Type, AsyncServiceCreatorWithProgressCallback)	Přidá do tohoto balíčku asynchronní službu, která podporuje aktualizace průběhu během inicializace. Tato služba nebude viditelná mimo tento balíček.
AddService(Type, AsyncServiceCreatorWithProgressCallback, Boolean)	Přidá do tohoto balíčku asynchronní službu, která podporuje aktualizace průběhu během inicializace. Tato služba může nebo nemusí být viditelná mimo tento balíček v závislosti na hodnotě .promote
CreateInstance(Guid, Guid, Type)	Vytvoří zadaný objekt COM pomocí objektu CLSID místního registru sady Visual Studio. (Zděděno od Package)
CreateTool(Guid)	Umožňuje odvozené třídy poskytovat implementaci v případě potřeby. (Zděděno od Package)
CreateToolWindow(Guid, Int32)	Vytvoří okno nástroje zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32)	Vytvoří okno nástroje zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, Object)	Create okno nástroje zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, UInt32)	Vytvoří okno nástroje zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Create okno nástroje zadaného typu se zadaným ID. Toto je jediná metoda, která by měla volat IVsUiShell.CreateToolWindow(). (Zděděno od Package)
Dispose(Boolean)	Odstraní objekt a přidružený token zrušení.
FindToolWindow(Type, Int32, Boolean)	Získá okno nástroje odpovídající zadanému typu a ID. (Zděděno od Package)
FindToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně vyhledá okno nástroje odpovídající zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí hodnotu, pokud create má hodnotu true, nebo vrátí hodnotu null, pokud create je nepravda.
FindWindowPane(Type, Int32, Boolean)	Získá podokno okna odpovídající zadanému typu a ID, a pokud neexistuje žádné podokno okna tohoto typu, vytvoří jedno, pokud to má udělat. (Zděděno od Package)
FindWindowPaneAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně vyhledá podokno okna odpovídající zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí hodnotu, pokud create má hodnotu true, nebo vrátí hodnotu null, pokud create je nepravda.
GetAsyncToolWindowFactory(Guid)	Vrátí asynchronní rozhraní pro vytváření oken nástrojů pro okno nástrojů identifikované nástrojem toolWindowType, pokud je pro okno nástrojů podporováno asynchronní vytváření. Pokud asynchronní vytváření není podporováno, vrátí se hodnota null.
GetAutomationObject(String)	Získá objekt automation pro VSPackage. (Zděděno od Package)
GetDialogPage(Type)	Získá požadovanou stránku dialogového okna. (Zděděno od Package)
GetOutputPane(Guid, String)	Získá okno požadovaného výstupu. (Zděděno od Package)
GetProviderLocale()	Vrátí národní prostředí přidružené k tomuto poskytovateli služeb. (Zděděno od Package)
GetService(Type)	Načte službu zaregistrovanou v tomto balíčku. Tato metoda je synchronní a i asynchronní služby načtené tímto způsobem se načtou synchronně.
GetServiceAsync(Type)	Načte asynchronní službu.
GetServiceAsync(Type, Boolean)	Načte asynchronní služby, ale umožní volajícímu naznačit, že výjimky nemusí být spolknuty. Nezaručuje však, že v případě selhání dojde k výjimkám.
GetToolboxItemData(String, DataFormats+Format)	Získá obsah datového formátu pro zadané id položky panelu nástrojů a formát dat. (Zděděno od Package)
GetToolboxItemDataAsync(String, DataFormats+Format)	Představuje balíček VSPackage, který může zpracovávat asynchronní služby. (Zděděno od Package)
GetToolWindowTitle(Type, Int32)	Vrátí název řetězce, který se má použít pro okno nástroje. Pokud je vrácena hodnota null, název typu okna nástroje se použije pro název.
Initialize()	Tuto metodu zapečetíte. Vzhledem k téměř nevyhnutelnému riziku vzájemného zablokování se setSite (což volá inicializace) stále vyskytuje ve vlákně uživatelského rozhraní, a to i pro asynchronní balíček. Vzhledem k tomu, že většina autorů asynchronních balíčků by logicky předpokládala, že k inicializaci dochází na vlákně b/g, mohou provádět nákladné (synchronní) věci uvnitř svého přepsání, a tím porazit některé výhody asynchronního zatížení. Abychom je mohli odvést od toho, zapečetíme to a vše, co můžou přepsat, je asynchronní inicializace, která je volána na vlákně b/g.
InitializeAsync(CancellationToken, IProgress<ServiceProgressData>)	Část asynchronní inicializace procesu inicializace balíčku. Tato metoda je vyvolána z vlákna na pozadí.
InitializeToolWindowAsync(Type, Int32, CancellationToken)	Provede inicializaci v rámci přípravy na vytvoření okna nástroje identifikovaného nástrojem toolWindowType.
InstantiateToolWindow(Type)	Představuje balíček VSPackage, který může zpracovávat asynchronní služby. (Zděděno od Package)
InstantiateToolWindow(Type, Object)	Vytvořte okno nástroje zadaného typu. (Zděděno od Package)
IsLocalService(Type)	Určuje, zda zadaný typ služby lze načíst bez nutnosti přechodu RPC na vlákno uživatelského rozhraní. (Zděděno od Package)
OnAfterPackageLoadedAsync(CancellationToken)	Při přepsání odvozeným typem může zahájit operace s vedlejšími účinky, které nejsou výhradně součástí zatížení balíčku, které by patřily InitializeAsync(CancellationToken, IProgress<ServiceProgressData>) , ale které by měly proběhnout brzy po načtení balíčku (např. aktualizace stavu příkazu).
OnLoadOptions(String, Stream)	Vyvolána třídou balíčku, pokud existují možnosti pro čtení ze souboru řešení. (Zděděno od Package)
OnSaveOptions(String, Stream)	Vyvolána Package třídou, pokud existují možnosti pro uložení do souboru řešení. (Zděděno od Package)
ParseToolboxResource(TextReader, Guid)	Analyzuje vložený textový prostředek odpovídajícího formátu pro informace o tom, které položky mají být přidány do sady nástrojů. (Zděděno od Package)
ParseToolboxResource(TextReader, ResourceManager)	Analyzuje vložený textový prostředek odpovídajícího formátu pro informace o tom, které položky mají být přidány do sady nástrojů. (Zděděno od Package)
QueryClose(Boolean)	Zavolá se, aby se balíček zeptal, jestli je možné prostředí zavřít. (Zděděno od Package)
RegisterEditorFactory(IVsEditorFactory)	Zaregistruje továrnu editoru v sadě Visual Studio. (Zděděno od Package)
RegisterProjectFactory(IVsProjectFactory)	Zaregistruje projektovou továrnu v sadě Visual Studio. (Zděděno od Package)
RemoveService(Type)	Odebere asynchronní službu zaregistrovanou v tomto balíčku.
RemoveService(Type, Boolean)	Odebere asynchronní službu zaregistrovanou v tomto balíčku.
ShowOptionPage(Type)	Zobrazí stránku s možnostmi zadaných nástrojů. (Zděděno od Package)
ShowToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně zobrazí okno nástroje odpovídající zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí hodnotu, pokud create má hodnotu true, nebo vrátí hodnotu null, pokud create je nepravda.

Událost

ToolboxInitialized	Událost vygenerovaná při každé inicializaci sady nástrojů sady Visual Studio. (Zděděno od Package)
ToolboxUpgraded	Událost vygenerovaná vždy, když sada Visual Studio upgraduje sadu nástrojů. (Zděděno od Package)

Explicitní implementace rozhraní

IAsyncLoadablePackageInitialize.Initialize(IAsyncServiceProvider, IProfferAsyncService, IAsyncProgressCallback)	Asynchronní verze SetSite, volal z b/g vlákna.
IAsyncServiceProvider.QueryServiceAsync(Guid)	Získejte službu asynchronní inicializace, kterou nabízí tento balíček.
IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Spustí zadaný příkaz nebo zobrazí nápovědu k příkazu. (Zděděno od Package)
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Dotazuje objekt na stav jednoho nebo více příkazů vygenerovaných událostmi uživatelského rozhraní. (Zděděno od Package)
IServiceContainer.AddService(Type, Object)	Přidá danou službu do kontejneru služby VSPackage. (Zděděno od Package)
IServiceContainer.AddService(Type, Object, Boolean)	Přidá danou službu do kontejneru služby VSPackage. (Zděděno od Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Přidá danou službu do kontejneru služby VSPackage. (Zděděno od Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Přidá danou službu do kontejneru služby pomocí zadaného ServiceCreatorCallbackparametru . (Zděděno od Package)
IServiceContainer.RemoveService(Type)	Odebere daný typ služby z kontejneru služby. (Zděděno od Package)
IServiceContainer.RemoveService(Type, Boolean)	Odebere daný typ služby z kontejneru služby a volitelně propaguje odebrání služby na nadřazené kontejnery služby. (Zděděno od Package)
IServiceProvider.GetService(Type)	Získá službu zadaného typu. (Zděděno od Package)
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Interní implementace IServiceProvider. (Zděděno od Package)
IVsAsyncToolWindowFactory.CreateToolWindow(Guid, UInt32, Object)	Vytvoří okno nástroje zadaného typu se zadaným ID.
IVsAsyncToolWindowFactory.GetToolWindowTitle(Guid, UInt32)	Vrátí název řetězce, který se má použít pro okno nástroje. Pokud je vrácena hodnota null, název typu okna nástroje se použije pro název.
IVsAsyncToolWindowFactory.InitializeToolWindowAsync(Guid, UInt32)	Provede inicializaci v rámci přípravy na vytvoření okna nástroje identifikovaného nástrojem toolWindowType.
IVsPackage.Close()	Zavře a zlikviduje balíček. (Zděděno od Package)
IVsPackage.GetAutomationObject(String, Object)	Získá objekt pro automatizaci pro tento balíček. (Zděděno od Package)
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Nabízí přístup k nabídce Nástroje Možnosti a stránky vlastností dialogových oken Přizpůsobit sadu nástrojů. (Zděděno od Package)
IVsPackage.QueryClose(Int32)	Volá se, aby se v balíčku VSPackage zeptal, jestli je možné zavřít prostředí sady Visual Studio. (Zděděno od Package)
IVsPackage.ResetDefaults(UInt32)	Obnoví výchozí nastavení sady nástrojů. (Zděděno od Package)
IVsPackage.SetSite(IServiceProvider)	Inicializuje balíček VSPackage v prostředí sady Visual Studio. (Zděděno od Package)
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Načte uživatelské možnosti pro dané řešení. (Zděděno od Package)
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Přečte možnosti uživatele pro dané řešení. (Zděděno od Package)
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Uloží uživatelské možnosti pro dané řešení. (Zděděno od Package)
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Zapíše uživatelské možnosti pro dané řešení. (Zděděno od Package)
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Získá položku. (Zděděno od Package)
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)	Představuje balíček VSPackage, který může zpracovávat asynchronní služby. (Zděděno od Package)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Vytvoří okno nástroje zadaného typu se zadaným ID. (Zděděno od Package)
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Tato metoda implementuje IVsUserSettings rozhraní sloužící ke správě profilů a importu/exportu nastavení do souborů XML. (Zděděno od Package)
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Načte konfiguraci sady VSPackage pomocí mechanismu nastavení sady Visual Studio, když uživatel vybere možnost importu funkce Nastavení importu/exportu v nabídce Nástroje integrovaného vývojového prostředí. Tato metoda je součástí implementace rozhraní používaného IVsUserSettings ke správě profilů a importu a exportu nastavení do souborů XML. (Zděděno od Package)
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Migruje nastavení z předchozí verze. (Zděděno od Package)
IVsUserSettingsQuery.NeedExport(String, Int32)	Určuje, jestli se nastavení změnilo a mělo by se znovu exportovat. (Zděděno od Package)

Metody rozšíření

ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>)	Umožňuje službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním creator dotazu na službu se zavolá funkce . Tato služba bude povýšena na nadřazený kontejner asynchronní služby.
ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>, Boolean)	Umožňuje službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním creator dotazu na službu se zavolá funkce .
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>)	Umožňuje službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním creator dotazu na službu se zavolá funkce . Tato služba bude povýšena na nadřazený kontejner asynchronní služby.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>, Boolean)	Umožňuje službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním creator dotazu na službu se zavolá funkce .
QueryService(IServiceProvider, Guid)	Získá službu vystavenou poskytovatelem služby na základě jeho identifikátoru GUID služby.
QueryService<TService>(IServiceProvider)	Získá službu vystavenou poskytovatelem služby na základě jejího typu služby.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider)	Získá rozhraní služby od poskytovatele služeb asynchronně.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider, Boolean)	Získá rozhraní služby od poskytovatele služeb asynchronně.