AsyncPackage Třída

Reference

Definice

Obor názvů:: Microsoft.VisualStudio.Shell

Sestavení:: Microsoft.VisualStudio.Shell.14.0.dll

Sestavení:: Microsoft.VisualStudio.Shell.15.0.dll

Sestavení:

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje 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::IAsyncServiceProvider, Microsoft::VisualStudio::Shell::Interop::IAsyncLoadablePackageInitialize, Microsoft::VisualStudio::Shell::Interop::IAsyncServiceProvider

public ref class AsyncPackage abstract : Microsoft::VisualStudio::Shell::Package, Microsoft::VisualStudio::Shell::IAsyncServiceContainer, 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]
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.IAsyncServiceProvider, Microsoft.VisualStudio.Shell.Interop.IAsyncLoadablePackageInitialize, Microsoft.VisualStudio.Shell.Interop.IAsyncServiceProvider

[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.IAsyncLoadablePackageInitialize, Microsoft.VisualStudio.Shell.Interop.IAsyncServiceProvider, 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 IAsyncServiceProvider
    interface IAsyncServiceContainer

[<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, IAsyncServiceProvider

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 IAsyncServiceProvider IAsyncServiceProvider2 IVsAsyncToolWindowFactory IVsAsyncToolWindowFactoryProvider

Konstruktory

AsyncPackage()

AsyncPackage výchozí konstruktor.

Vlastnosti

ApplicationRegistryRoot	Načte klíč kořenového registru aktuálního podregistru sady Visual Studio. (Zděděno od Package)
DisposalToken	Zpřístupňuje CancellationToken , které lze použít ke kontrole, zda byl balíček vyřazen. Tato situace může nastat u asynchronních úloh, které jsou spuštěny ve vlákně na pozadí při spuštění aplikace Visual Studio. Použijte ShutdownToken pro předchozí indikaci, že vs se vypíná.
JoinableTaskCollection	Získá kolekci asynchronních úloh spuštěných tímto balíčkem.
JoinableTaskFactory	Získá továrnu, která se použije pro asynchronní úlohy spuštěné tímto balíčkem.
UserDataPath	Získá cestu k úložišti uživatelských dat pro Visual Studio. (Zděděno od Package)
UserLocalDataPath	Získá cestu k místnímu úložišti dat uživatelů pro Visual Studio. (Zděděno od Package)
UserRegistryRoot	Načte klíč registru, který se dá použít k ukládání uživatelských dat. (Zděděno od Package)
Zombied	Načte hodnotu, která označuje, jestli se balíček v procesu vypnutí vypíná. (Zděděno od Package)

Metody

AddOptionKey(String)	Do seznamu klíčů možností přidá název klíče možnosti uživatele. (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á během inicializace podporuje aktualizace průběhu. Tato služba nebude viditelná mimo tento balíček.
AddService(Type, AsyncServiceCreatorWithProgressCallback, Boolean)	Přidá do tohoto balíčku asynchronní službu, která během inicializace podporuje aktualizace průběhu. 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 aplikace Visual Studio. (Zděděno od Package)
CreateTool(Guid)	Umožňuje odvozeným třídám poskytnout implementaci v případě potřeby. (Zděděno od Package)
CreateToolWindow(Guid, Int32)	Vytvoří okno nástrojů zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32)	Vytvoří okno nástrojů zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, Object)	Vytvoří okno nástrojů zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, UInt32)	Vytvoří okno nástrojů zadaného typu se zadaným ID. (Zděděno od Package)
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Vytvoří okno nástrojů zadaného typu se zadaným ID. Toto je jediná metoda, která by se 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, které odpovídá zadanému typu a ID. (Zděděno od Package)
FindToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně vyhledá okno nástroje, které odpovídá zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí jeden, pokud `create` má hodnotu true, nebo vrátí hodnotu null, pokud `create` má hodnotu false.
FindWindowPane(Type, Int32, Boolean)	Získá podokno okna, které odpovídá zadanému typu a ID a v případě, že k tomu neexistují žádné podokno okna tohoto typu. (Zděděno od Package)
FindWindowPaneAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně vyhledá podokno okna, které odpovídá zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí jeden, pokud `create` má hodnotu true, nebo vrátí hodnotu null, pokud `create` má hodnotu false.
GetAsyncToolWindowFactory(Guid)	Vrátí rozhraní Factory okna asynchronního nástroje pro okno nástroje, které je určeno nástrojem `toolWindowType` , pokud je pro okno nástroje podporováno asynchronní vytváření. Pokud není podporováno asynchronní vytvoření, je vrácena hodnota null.
GetAutomationObject(String)	Získá automatizační objekt 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á požadované okno 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 dokonce i asynchronní služby, které jsou načteny tímto způsobem, budou načteny synchronně.
GetServiceAsync(Type)	Načte asynchronní službu.
GetServiceAsync(Type, Boolean)	Načte asynchronní služby, ale umožňuje volajícímu pomocným parametrům, že výjimky nemusí být požitíné. Pro případy selhání ale nezaručuje, že se vyvolají výjimky.
GetToolboxItemData(String, DataFormats+Format)	Získá obsah formátu dat pro zadaný identifikátor položky sady nástrojů a formát dat. (Zděděno od Package)
GetToolboxItemDataAsync(String, DataFormats+Format)	(Zděděno od Package)
GetToolWindowTitle(Type, Int32)	Vrátí řetězec názvu, který se má použít pro okno nástroje. Pokud je vrácena hodnota null, pro název se použije název typu okna nástroje.
Initialize()	Zapečetit tuto metodu. Vzhledem k téměř nenevyhnutelnému riziku zablokování, SetSite (což znamená vyvolání volání) stále probíhá u vlákna uživatelského rozhraní i pro asynchronní balíček. Vzhledem k tomu, že většina autorů asynchronních balíčků by logicky předpokládat, že k inicializaci dojde ve vláknu b/g, mohou v rámci jejich přepsání provádět nákladné (synchronní) věci, takže některé z výhod asynchronních načtení se nezdařily. Abychom jim usnadnili, že ji zařadíme, a to všechno, co může přepsat, je asynchronní inicializace, která je volána ve vlákně b/g.
InitializeAsync(CancellationToken, IProgress<ServiceProgressData>)	Asynchronní inicializační část procesu inicializace balíčku. Tato metoda je vyvolána z vlákna na pozadí.
InitializeToolWindowAsync(Type, Int32, CancellationToken)	Provede inicializaci při přípravě pro vytvoření panelu nástrojů určeného `toolWindowType` .
InstantiateToolWindow(Type)	(Zděděno od Package)
InstantiateToolWindow(Type, Object)	Sestavte okno nástroje zadaného typu. (Zděděno od Package)
IsLocalService(Type)	Určuje, zda lze typ zadané služby načíst bez nutnosti přechodu RPC do vlákna uživatelského rozhraní. (Zděděno od Package)
OnAfterPackageLoadedAsync(CancellationToken)	Pokud je přepsáno odvozeným typem, může iniciovat operace s vedlejšími účinky, které nejsou naprosto součástí zatížení balíčku, které by mohly patřit k InitializeAsync(CancellationToken, IProgress<ServiceProgressData>) , ale které by měly být brzy po načtení balíčku (například stav příkazu aktualizovat).
OnLoadOptions(String, Stream)	Vyvoláno třídou balíčku, pokud existují možnosti pro čtení ze souboru řešení. (Zděděno od Package)
OnSaveOptions(String, Stream)	Vyvoláno Package třídou, pokud existují možnosti uložení do souboru řešení. (Zděděno od Package)
ParseToolboxResource(TextReader, Guid)	Analyzuje prostředek vloženého textu odpovídajícího formátu pro informace o tom, které položky by měly být přidány do sady nástrojů. (Zděděno od Package)
ParseToolboxResource(TextReader, ResourceManager)	Analyzuje prostředek vloženého textu odpovídajícího formátu pro informace o tom, které položky by měly být přidány do sady nástrojů. (Zděděno od Package)
QueryClose(Boolean)	Volá se, aby se balíček vyžádal, pokud se prostředí dá zavřít. (Zděděno od Package)
RegisterEditorFactory(IVsEditorFactory)	Zaregistruje objekt pro vytváření editoru pomocí sady Visual Studio. (Zděděno od Package)
RegisterProjectFactory(IVsProjectFactory)	Zaregistruje objekt pro vytváření projektů pomocí sady 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í zadanou stránku možností nástrojů. (Zděděno od Package)
ShowToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Asynchronně zobrazuje okno nástroje, které odpovídá zadanému typu a ID. Pokud neexistuje, vytvoří a vrátí jeden, pokud `create` má hodnotu true, nebo vrátí hodnotu null, pokud `create` má hodnotu false.

událost

ToolboxInitialized	Událost vytvořená vždy, když Visual Studio inicializuje jeho sadu nástrojů. (Zděděno od Package)
ToolboxUpgraded	Událost generovaná při každé upgradování sady Visual Studio (Zděděno od Package)

Explicitní implementace rozhraní

IAsyncLoadablePackageInitialize.Initialize(IAsyncServiceProvider, IProfferAsyncService, IAsyncProgressCallback)	Asynchronní verze SetSite volaná z vlákna b/g.
IAsyncServiceProvider.QueryServiceAsync(Guid)	Získejte asynchronní inicializační službu, kterou tento balíček nabízí.
IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Provede 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ů generovaný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 prostřednictvím zadaného typu ServiceCreatorCallback . (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 případně povýší odebrání služby do kontejnerů nadřazených služeb. (Zděděno od Package)
IServiceProvider.GetService(Type)	Načte 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ástrojů zadaného typu se zadaným ID.
IVsAsyncToolWindowFactory.GetToolWindowTitle(Guid, UInt32)	Vrátí řetězec názvu, který se má použít pro okno nástroje. Pokud je vrácena hodnota null, pro název se použije název typu okna nástroje.
IVsAsyncToolWindowFactory.InitializeToolWindowAsync(Guid, UInt32)	Provede inicializaci při přípravě pro vytvoření panelu nástrojů určeného `toolWindowType` .
IVsPackage.Close()	Zavře a odstraní balíček. (Zděděno od Package)
IVsPackage.GetAutomationObject(String, Object)	Získá uživatelsky přívětivý objekt pro tento balíček. (Zděděno od Package)
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Proffers přístup k možnostem nabídky nástroje a ke stránkám vlastností dialogových oken přizpůsobení sady nástrojů. (Zděděno od Package)
IVsPackage.QueryClose(Int32)	Volá se, aby se vyžádala VSPackage, pokud se dá zavřít prostředí Visual studia. (Zděděno od Package)
IVsPackage.ResetDefaults(UInt32)	Obnoví výchozí nastavení sady nástrojů. (Zděděno od Package)
IVsPackage.SetSite(IServiceProvider)	Inicializuje 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)	Zapisuje 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)	(Zděděno od Package)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Vytvoří okno nástrojů zadaného typu se zadaným ID. (Zděděno od Package)
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Tato metoda implementuje IVsUserSettings rozhraní používané ke správě profilů a nastavení importu a exportu 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 Import funkce nastavení importu/exportu v nabídce nástroje IDE. Tato metoda je součástí implementace IVsUserSettings rozhraní používaného ke správě profilů a nastavení import/export 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, zda došlo ke změně nastavení a které by mělo být znovu exportováno. (Zděděno od Package)

Metody rozšíření

ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>)	Proffers službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním dotazování služby se `creator` funkce zavolá. Služba proffered se povýší do nadřazeného kontejneru asynchronní služby.
ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>, Boolean)	Proffers službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním dotazování služby se `creator` funkce zavolá.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>)	Proffers službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním dotazování služby se `creator` funkce zavolá. Služba proffered se povýší do nadřazeného kontejneru asynchronní služby.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>, Boolean)	Proffers službu implementovanou zadaným typem do kontejneru asynchronní služby. Při prvním dotazování služby se `creator` funkce zavolá.
QueryService(IServiceProvider, Guid)	Načte službu vystavenou poskytovatelem služeb na základě jejího typu služby.
QueryService<TService>(IServiceProvider)	Načte službu vystavenou poskytovatelem služeb na základě jejího typu služby.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider)	Získá rozhraní služby od poskytovatele služby asynchronně.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider, Boolean)	Získá rozhraní služby od poskytovatele služby asynchronně.

Platí pro