AsyncPackage Kelas

Definisi

Ruang nama:

Microsoft.VisualStudio.Shell

Rakitan:

Microsoft.VisualStudio.Shell.15.0.dll

Paket:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Mewakili VSPackage yang dapat menangani layanan asinkron.

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

Warisan

Object

Package

AsyncPackage

Turunan

Microsoft.VisualStudio.Modeling.Shell.AsyncModelingPackage

Microsoft.VisualStudio.Shell.ExtensionPointAsyncPackage

Atribut

ComVisibleAttribute

Penerapan

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

Konstruktor

AsyncPackage()

Konstruktor default AsyncPackage.

Properti

ApplicationRegistryRoot	Mendapatkan kunci registri akar dari sarang registri Visual Studio saat ini. (Diperoleh dari Package)
DisposalToken	CancellationToken Mengekspos yang dapat digunakan untuk memeriksa apakah paket telah dibuang. Ini dapat terjadi untuk tugas asinkron yang berjalan pada utas latar belakang saat Visual Studio mulai dimatikan. Gunakan ShutdownToken untuk indikasi sebelumnya bahwa VS dimatikan.
JoinableTaskCollection	Mendapatkan kumpulan tugas asinkron yang dimulai oleh paket ini.
JoinableTaskFactory	Mendapatkan pabrik yang akan digunakan untuk tugas asinkron yang dimulai oleh paket ini.
UserDataPath	Mendapatkan jalur ke penyimpanan data pengguna untuk Visual Studio. (Diperoleh dari Package)
UserLocalDataPath	Mendapatkan jalur ke penyimpanan data pengguna lokal untuk Visual Studio. (Diperoleh dari Package)
UserRegistryRoot	Mendapatkan kunci registri yang dapat digunakan untuk menyimpan data pengguna. (Diperoleh dari Package)
Zombied	Mendapatkan nilai yang menunjukkan apakah paket dalam proses pematian. (Diperoleh dari Package)

Metode

AddOptionKey(String)	Menambahkan nama kunci opsi pengguna ke dalam daftar kunci opsi. (Diperoleh dari Package)
AddService(Type, AsyncServiceCreatorCallback)	Menambahkan layanan asinkron ke paket ini. Layanan ini tidak akan terlihat di luar paket ini.
AddService(Type, AsyncServiceCreatorCallback, Boolean)	Menambahkan layanan asinkron ke paket ini. Layanan ini mungkin atau mungkin tidak terlihat di luar paket ini, tergantung pada nilai promote.
AddService(Type, AsyncServiceCreatorWithProgressCallback)	Menambahkan layanan asinkron ke paket ini yang mendukung pembaruan kemajuan selama inisialisasi. Layanan ini tidak akan terlihat di luar paket ini.
AddService(Type, AsyncServiceCreatorWithProgressCallback, Boolean)	Menambahkan layanan asinkron ke paket ini yang mendukung pembaruan kemajuan selama inisialisasi. Layanan ini mungkin atau mungkin tidak terlihat di luar paket ini, tergantung pada nilai promote.
CreateInstance(Guid, Guid, Type)	Membuat objek COM yang ditentukan menggunakan objek CLSID registri lokal Visual Studio. (Diperoleh dari Package)
CreateTool(Guid)	Memungkinkan kelas turunan untuk memberikan implementasi jika perlu. (Diperoleh dari Package)
CreateToolWindow(Guid, Int32)	Membuat jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. (Diperoleh dari Package)
CreateToolWindow(Type, Int32)	Membuat jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. (Diperoleh dari Package)
CreateToolWindow(Type, Int32, Object)	Create jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. (Diperoleh dari Package)
CreateToolWindow(Type, Int32, UInt32)	Membuat jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. (Diperoleh dari Package)
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Create jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. Ini adalah satu-satunya metode yang harus memanggil IVsUiShell.CreateToolWindow() (Diperoleh dari Package)
Dispose(Boolean)	Membuang objek dan token pembatalan terkait.
FindToolWindow(Type, Int32, Boolean)	Mendapatkan jendela alat yang sesuai dengan jenis dan ID yang ditentukan. (Diperoleh dari Package)
FindToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Secara asinkron menemukan jendela alat yang sesuai dengan jenis dan ID yang ditentukan. Jika tidak ada, itu membuat dan mengembalikannya jika create benar, atau mengembalikan null jika create false.
FindWindowPane(Type, Int32, Boolean)	Mendapatkan panel jendela yang sesuai dengan jenis dan ID yang ditentukan, dan jika tidak ada panel jendela dari jenis tersebut, buatlah jika disuruh melakukannya. (Diperoleh dari Package)
FindWindowPaneAsync(Type, Int32, Boolean, CancellationToken)	Secara asinkron menemukan panel jendela yang sesuai dengan jenis dan ID yang ditentukan. Jika tidak ada, itu membuat dan mengembalikannya jika create benar, atau mengembalikan null jika create false.
GetAsyncToolWindowFactory(Guid)	Mengembalikan antarmuka pabrik jendela alat asinkron untuk jendela alat yang diidentifikasi oleh toolWindowType, jika pembuatan asinkron didukung untuk jendela alat. Jika pembuatan asinkron tidak didukung, null dikembalikan.
GetAutomationObject(String)	Mendapatkan objek otomatisasi untuk VSPackage. (Diperoleh dari Package)
GetDialogPage(Type)	Mendapatkan halaman dialog yang diminta. (Diperoleh dari Package)
GetOutputPane(Guid, String)	Mendapatkan jendela output yang diminta. (Diperoleh dari Package)
GetProviderLocale()	Mengembalikan lokal yang terkait dengan penyedia layanan ini. (Diperoleh dari Package)
GetService(Type)	Mengambil layanan yang terdaftar dengan paket ini. Metode ini sinkron dan bahkan layanan asinkron yang diambil dengan cara ini akan diambil secara sinkron.
GetServiceAsync(Type)	Mengambil layanan asinkron.
GetServiceAsync(Type, Boolean)	Mengambil layanan asinkron tetapi memungkinkan penelepon untuk mengisyaratkan bahwa pengecualian mungkin tidak harus ditelan. Ini tidak menjamin pengecualian akan dilemparkan namun untuk kasus kegagalan.
GetToolboxItemData(String, DataFormats+Format)	Mendapatkan konten format data untuk ID item kotak alat dan format data yang ditentukan. (Diperoleh dari Package)
GetToolboxItemDataAsync(String, DataFormats+Format)	Mewakili VSPackage yang dapat menangani layanan asinkron. (Diperoleh dari Package)
GetToolWindowTitle(Type, Int32)	Mengembalikan string judul yang akan digunakan untuk jendela alat. Jika null dikembalikan, nama jenis jendela alat digunakan untuk judul.
Initialize()	Segel metode ini. Karena risiko kebuntuan yang hampir tidak dapat ditolak, SetSite (yang merupakan panggilan Inisialisasi) masih terjadi pada utas UI bahkan untuk paket asinkron. Karena sebagian besar penulis paket asinkron akan, secara logis, berasumsi bahwa Inisialisasi terjadi pada utas b/g, mereka mungkin melakukan hal-hal mahal (sinkron) di dalam penimpaan mereka, mengalahkan beberapa manfaat beban asinkron. Untuk membantu membawa mereka menjauh dari itu kita akan menyegelnya dan dengan demikian semua yang dapat mereka ambil alih adalah inisialisasi asinkron, yang dipanggil pada utas b/g.
InitializeAsync(CancellationToken, IProgress<ServiceProgressData>)	Bagian inisialisasi asinkron dari proses inisialisasi paket. Metode ini dipanggil dari utas latar belakang.
InitializeToolWindowAsync(Type, Int32, CancellationToken)	Melakukan inisialisasi sebagai persiapan untuk membuat jendela alat yang diidentifikasi oleh toolWindowType.
InstantiateToolWindow(Type)	Mewakili VSPackage yang dapat menangani layanan asinkron. (Diperoleh dari Package)
InstantiateToolWindow(Type, Object)	Buat jendela alat dari jenis yang ditentukan. (Diperoleh dari Package)
IsLocalService(Type)	Menentukan apakah jenis layanan yang ditentukan dapat diambil tanpa memerlukan transisi RPC ke utas UI. (Diperoleh dari Package)
OnAfterPackageLoadedAsync(CancellationToken)	Ketika ditimpa oleh jenis turunan, dapat memulai operasi dengan efek samping yang tidak benar-benar merupakan bagian dari beban paket yang akan menjadi milik InitializeAsync(CancellationToken, IProgress<ServiceProgressData>) tetapi itu harus terjadi segera setelah beban paket (misalnya memperbarui status perintah).
OnLoadOptions(String, Stream)	Dipanggil oleh kelas paket ketika ada opsi untuk dibaca dari file solusi. (Diperoleh dari Package)
OnSaveOptions(String, Stream)	Dipanggil oleh Package kelas ketika ada opsi untuk disimpan ke file solusi. (Diperoleh dari Package)
ParseToolboxResource(TextReader, Guid)	Mengurai sumber daya teks yang disematkan dengan format yang sesuai untuk informasi tentang item mana yang harus ditambahkan ke Kotak Alat. (Diperoleh dari Package)
ParseToolboxResource(TextReader, ResourceManager)	Mengurai sumber daya teks yang disematkan dengan format yang sesuai untuk informasi tentang item mana yang harus ditambahkan ke Kotak Alat. (Diperoleh dari Package)
QueryClose(Boolean)	Dipanggil untuk menanyakan paket apakah shell dapat ditutup. (Diperoleh dari Package)
RegisterEditorFactory(IVsEditorFactory)	Mendaftarkan pabrik editor dengan Visual Studio. (Diperoleh dari Package)
RegisterProjectFactory(IVsProjectFactory)	Mendaftarkan pabrik proyek dengan Visual Studio. (Diperoleh dari Package)
RemoveService(Type)	Menghapus layanan asinkron yang terdaftar dengan paket ini.
RemoveService(Type, Boolean)	Menghapus layanan asinkron yang terdaftar dengan paket ini.
ShowOptionPage(Type)	Menampilkan halaman opsi alat yang ditentukan. (Diperoleh dari Package)
ShowToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Secara asinkron menunjukkan jendela alat yang sesuai dengan jenis dan ID yang ditentukan. Jika tidak ada, itu membuat dan mengembalikannya jika create benar, atau mengembalikan null jika create false.

Acara

ToolboxInitialized	Peristiwa yang dihasilkan setiap kali Visual Studio menginisialisasi Kotak Alatnya. (Diperoleh dari Package)
ToolboxUpgraded	Peristiwa yang dihasilkan setiap kali Visual Studio meningkatkan Kotak Alatnya. (Diperoleh dari Package)

Implementasi Antarmuka Eksplisit

IAsyncLoadablePackageInitialize.Initialize(IAsyncServiceProvider, IProfferAsyncService, IAsyncProgressCallback)	Versi asinkron SetSite, dipanggil dari utas b/g.
IAsyncServiceProvider.QueryServiceAsync(Guid)	Dapatkan layanan inisialisasi asinkron yang ditawarkan oleh paket ini.
IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Menjalankan perintah tertentu atau menampilkan bantuan untuk perintah. (Diperoleh dari Package)
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Mengkueri objek untuk status satu atau beberapa perintah yang dihasilkan oleh peristiwa antarmuka pengguna. (Diperoleh dari Package)
IServiceContainer.AddService(Type, Object)	Menambahkan layanan yang diberikan ke kontainer layanan VSPackage. (Diperoleh dari Package)
IServiceContainer.AddService(Type, Object, Boolean)	Menambahkan layanan yang diberikan ke kontainer layanan VSPackage. (Diperoleh dari Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Menambahkan layanan yang diberikan ke kontainer layanan VSPackage. (Diperoleh dari Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Menambahkan layanan yang diberikan ke kontainer layanan dengan cara yang ditentukan ServiceCreatorCallback. (Diperoleh dari Package)
IServiceContainer.RemoveService(Type)	Menghapus jenis layanan yang diberikan dari kontainer layanan. (Diperoleh dari Package)
IServiceContainer.RemoveService(Type, Boolean)	Menghapus jenis layanan yang diberikan dari kontainer layanan, dan secara opsional mempromosikan penghapusan layanan ke kontainer layanan induk. (Diperoleh dari Package)
IServiceProvider.GetService(Type)	Mendapatkan layanan dari jenis yang ditentukan. (Diperoleh dari Package)
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Implementasi IServiceProvider internal. (Diperoleh dari Package)
IVsAsyncToolWindowFactory.CreateToolWindow(Guid, UInt32, Object)	Membuat jendela alat dari jenis yang ditentukan dengan ID yang ditentukan.
IVsAsyncToolWindowFactory.GetToolWindowTitle(Guid, UInt32)	Mengembalikan string judul yang akan digunakan untuk jendela alat. Jika null dikembalikan, nama jenis jendela alat digunakan untuk judul.
IVsAsyncToolWindowFactory.InitializeToolWindowAsync(Guid, UInt32)	Melakukan inisialisasi sebagai persiapan untuk membuat jendela alat yang diidentifikasi oleh toolWindowType.
IVsPackage.Close()	Menutup dan membuang paket. (Diperoleh dari Package)
IVsPackage.GetAutomationObject(String, Object)	Mendapatkan objek yang ramah otomatisasi untuk paket ini. (Diperoleh dari Package)
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Proffer akses ke menu Alat Opsi dan halaman properti kotak dialog Kustomisasi Kotak Alat. (Diperoleh dari Package)
IVsPackage.QueryClose(Int32)	Dipanggil untuk bertanya kepada VSPackage apakah shell Visual Studio dapat ditutup. (Diperoleh dari Package)
IVsPackage.ResetDefaults(UInt32)	Mengatur ulang default Kotak Alat. (Diperoleh dari Package)
IVsPackage.SetSite(IServiceProvider)	Menginisialisasi VSPackage di lingkungan Visual Studio. (Diperoleh dari Package)
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Memuat opsi pengguna untuk solusi tertentu. (Diperoleh dari Package)
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Membaca opsi pengguna untuk solusi tertentu. (Diperoleh dari Package)
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Menyimpan opsi pengguna untuk solusi tertentu. (Diperoleh dari Package)
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Menulis opsi pengguna untuk solusi tertentu. (Diperoleh dari Package)
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Mendapatkan item. (Diperoleh dari Package)
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)	Mewakili VSPackage yang dapat menangani layanan asinkron. (Diperoleh dari Package)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Membuat jendela alat dari jenis yang ditentukan dengan ID yang ditentukan. (Diperoleh dari Package)
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Metode ini mengimplementasikan Antarmuka yang IVsUserSettings digunakan untuk mengelola profil dan mengimpor/mengekspor pengaturan ke file XML. (Diperoleh dari Package)
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Mengambil konfigurasi VSPackage menggunakan mekanisme pengaturan Visual Studio saat pengguna memilih opsi impor fitur Pengaturan Impor/Ekspor pada menu Alat IDE. Metode ini adalah bagian dari implementasi antarmuka yang IVsUserSettings digunakan untuk mengelola profil dan mengimpor/mengekspor pengaturan ke file XML. (Diperoleh dari Package)
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Memigrasikan pengaturan dari versi sebelumnya. (Diperoleh dari Package)
IVsUserSettingsQuery.NeedExport(String, Int32)	Menentukan apakah pengaturan telah berubah dan harus diekspor ulang. (Diperoleh dari Package)

Metode Ekstensi

ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>)	Membuat proffer layanan yang diimplementasikan oleh jenis yang ditentukan ke kontainer layanan asinkron. Ketika layanan dikueri pertama kalinya, creator fungsi akan dipanggil. Layanan yang diproffer akan dipromosikan ke kontainer layanan asinkron induk.
ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>, Boolean)	Membuat proffer layanan yang diimplementasikan oleh jenis yang ditentukan ke kontainer layanan asinkron. Ketika layanan dikueri pertama kalinya, creator fungsi akan dipanggil.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>)	Membuat proffer layanan yang diimplementasikan oleh jenis yang ditentukan ke kontainer layanan asinkron. Ketika layanan dikueri pertama kalinya, creator fungsi akan dipanggil. Layanan yang diproffer akan dipromosikan ke kontainer layanan asinkron induk.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>, Boolean)	Membuat proffer layanan yang diimplementasikan oleh jenis yang ditentukan ke kontainer layanan asinkron. Ketika layanan dikueri pertama kalinya, creator fungsi akan dipanggil.
QueryService(IServiceProvider, Guid)	Mendapatkan layanan yang diekspos oleh penyedia layanan berdasarkan GUID layanannya.
QueryService<TService>(IServiceProvider)	Mendapatkan layanan yang diekspos oleh penyedia layanan berdasarkan jenis layanannya.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider)	Mendapatkan antarmuka layanan dari penyedia layanan secara asinkron.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider, Boolean)	Mendapatkan antarmuka layanan dari penyedia layanan secara asinkron.