AsyncPackage Clase

Definición

Espacio de nombres:

Microsoft.VisualStudio.Shell

Ensamblado:

Microsoft.VisualStudio.Shell.15.0.dll

Paquete:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Representa un VSPackage que puede controlar servicios asincrónicos.

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

Herencia

Object

Package

AsyncPackage

Derivado

Microsoft.VisualStudio.Modeling.Shell.AsyncModelingPackage

Microsoft.VisualStudio.Shell.ExtensionPointAsyncPackage

Atributos

ComVisibleAttribute

Implementaciones

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

Constructores

AsyncPackage()

Constructor predeterminado de AsyncPackage.

Propiedades

ApplicationRegistryRoot	Obtiene la clave del Registro raíz del subárbol actual del Registro de Visual Studio. (Heredado de Package)
DisposalToken	Expone un CancellationToken objeto que se puede usar para comprobar si se ha eliminado el paquete. Esto puede ocurrir para tareas asincrónicas que se ejecutan en un subproceso en segundo plano cuando Visual Studio ha empezado a apagarse. Se usa ShutdownToken para una indicación anterior de que VS se está cerrando.
JoinableTaskCollection	Obtiene la colección de tareas asincrónicas iniciadas por este paquete.
JoinableTaskFactory	Obtiene el generador que se va a usar para las tareas asincrónicas iniciadas por este paquete.
UserDataPath	Obtiene la ruta de acceso al almacenamiento de datos de usuario para Visual Studio. (Heredado de Package)
UserLocalDataPath	Obtiene la ruta de acceso al almacenamiento de datos de usuario local para Visual Studio. (Heredado de Package)
UserRegistryRoot	Obtiene una clave del Registro que se puede usar para almacenar datos de usuario. (Heredado de Package)
Zombied	Obtiene un valor que indica si el paquete actual está en proceso de cierre. (Heredado de Package)

Métodos

AddOptionKey(String)	Agrega un nombre de tecla de opción de usuario a la lista de teclas de opción. (Heredado de Package)
AddService(Type, AsyncServiceCreatorCallback)	Agrega un servicio asincrónico a este paquete. Este servicio no estará visible fuera de este paquete.
AddService(Type, AsyncServiceCreatorCallback, Boolean)	Agrega un servicio asincrónico a este paquete. Este servicio puede o no estar visible fuera de este paquete, dependiendo del valor de promote.
AddService(Type, AsyncServiceCreatorWithProgressCallback)	Agrega un servicio asincrónico a este paquete que admite actualizaciones de progreso durante la inicialización. Este servicio no estará visible fuera de este paquete.
AddService(Type, AsyncServiceCreatorWithProgressCallback, Boolean)	Agrega un servicio asincrónico a este paquete que admite actualizaciones de progreso durante la inicialización. Este servicio puede o no estar visible fuera de este paquete, dependiendo del valor de promote.
CreateInstance(Guid, Guid, Type)	Crea el objeto COM especificado mediante el objeto CLSID del Registro local de Visual Studio. (Heredado de Package)
CreateTool(Guid)	Habilita que las clases derivadas proporcionen una implementación en caso necesario. (Heredado de Package)
CreateToolWindow(Guid, Int32)	Crea una ventana de herramientas del tipo especificado con el identificador especificado. (Heredado de Package)
CreateToolWindow(Type, Int32)	Crea una ventana de herramientas del tipo especificado con el identificador especificado. (Heredado de Package)
CreateToolWindow(Type, Int32, Object)	Create una ventana de herramientas del tipo especificado con el identificador especificado. (Heredado de Package)
CreateToolWindow(Type, Int32, UInt32)	Crea una ventana de herramientas del tipo especificado con el identificador especificado. (Heredado de Package)
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Create una ventana de herramientas del tipo especificado con el identificador especificado. Este es el único método que debe llamar a IVsUiShell.CreateToolWindow() (Heredado de Package)
Dispose(Boolean)	Elimina el objeto y el token de cancelación asociado.
FindToolWindow(Type, Int32, Boolean)	Obtiene la ventana de herramientas que corresponde al tipo y el identificador especificados. (Heredado de Package)
FindToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Localiza de forma asincrónica la ventana de herramientas correspondiente al tipo y el identificador especificados. Si no existe, crea y devuelve uno si create es true o devuelve null si create es false.
FindWindowPane(Type, Int32, Boolean)	Obtiene el panel de ventana correspondiente al tipo y el identificador especificados, y si no existe ningún panel de ventana de ese tipo crea uno si se le indica. (Heredado de Package)
FindWindowPaneAsync(Type, Int32, Boolean, CancellationToken)	Localiza de forma asincrónica el panel de ventana correspondiente al tipo y el identificador especificados. Si no existe, crea y devuelve uno si create es true o devuelve null si create es false.
GetAsyncToolWindowFactory(Guid)	Devuelve la interfaz de generador de ventanas de herramientas asincrónica para la ventana de herramientas identificada por toolWindowType, si se admite la creación asincrónica para la ventana de herramientas. Si no se admite la creación asincrónica, se devuelve null.
GetAutomationObject(String)	Obtiene el objeto de automatización para VSPackage. (Heredado de Package)
GetDialogPage(Type)	Obtiene la página de diálogo solicitada. (Heredado de Package)
GetOutputPane(Guid, String)	Obtiene la ventana de salida solicitada. (Heredado de Package)
GetProviderLocale()	Devuelve la configuración regional asociada a este proveedor de servicio. (Heredado de Package)
GetService(Type)	Recupera un servicio registrado con este paquete. Este método es sincrónico e incluso los servicios asincrónicos recuperados de esta manera se recuperarán sincrónicamente.
GetServiceAsync(Type)	Recupera un servicio asincrónico.
GetServiceAsync(Type, Boolean)	Recupera un servicio asincrónico, pero permite al autor de la llamada sugerir que es posible que las excepciones no tengan que tragarse. Sin embargo, no garantiza que se produzcan excepciones para casos de error.
GetToolboxItemData(String, DataFormats+Format)	Obtiene el contenido del formato de datos para el identificador del elemento de la caja de herramientas y para el formato de datos especificados. (Heredado de Package)
GetToolboxItemDataAsync(String, DataFormats+Format)	Representa un VSPackage que puede controlar servicios asincrónicos. (Heredado de Package)
GetToolWindowTitle(Type, Int32)	Devuelve la cadena de título que se va a usar para la ventana de herramientas. Si se devuelve null, el nombre de tipo de la ventana de herramientas se usa para el título.
Initialize()	Sellar este método. Debido a un riesgo casi inevitable de interbloqueo, SetSite (que es lo que llama a Initialize) se sigue produciendo en el subproceso de interfaz de usuario incluso para el paquete asincrónico. Dado que la mayoría de los autores de paquetes asincrónicos asumirían lógicamente que Initialize se produce en un subproceso b/g, pueden hacer cosas costosas (sincrónicas) dentro de su invalidación, lo que anula algunas de las ventajas de las cargas asincrónicas. Para ayudar a alejarlos de que lo sellaremos y, por lo tanto, todo lo que pueden invalidar es inicializar asincrónico, que se llama en el subproceso b/g.
InitializeAsync(CancellationToken, IProgress<ServiceProgressData>)	Parte de inicialización asincrónica del proceso de inicialización del paquete. Este método se invoca desde un subproceso en segundo plano.
InitializeToolWindowAsync(Type, Int32, CancellationToken)	Realiza la inicialización como preparación para crear la ventana de herramientas identificada por toolWindowType.
InstantiateToolWindow(Type)	Representa un VSPackage que puede controlar servicios asincrónicos. (Heredado de Package)
InstantiateToolWindow(Type, Object)	Construya una ventana de herramientas del tipo especificado. (Heredado de Package)
IsLocalService(Type)	Determina si el tipo de servicio especificado se puede recuperar sin necesidad de realizar una transición rpc al subproceso de la interfaz de usuario. (Heredado de Package)
OnAfterPackageLoadedAsync(CancellationToken)	Cuando se reemplaza por un tipo derivado, puede iniciar operaciones con efectos secundarios que no son estrictamente una parte de la carga del paquete que pertenecería, InitializeAsync(CancellationToken, IProgress<ServiceProgressData>) pero que debería ocurrir poco después de la carga del paquete (por ejemplo, actualizar el estado del comando).
OnLoadOptions(String, Stream)	Se invoca por la clase de paquete cuando hay opciones de lectura en el archivo de solución. (Heredado de Package)
OnSaveOptions(String, Stream)	Se invoca por la clase Package cuando hay opciones de guardar en el archivo de solución. (Heredado de Package)
ParseToolboxResource(TextReader, Guid)	Analiza un recurso de texto incrustado con el formato adecuado para obtener información sobre qué elementos se deben agregar al Cuadro de herramientas. (Heredado de Package)
ParseToolboxResource(TextReader, ResourceManager)	Analiza un recurso de texto incrustado con el formato adecuado para obtener información sobre qué elementos se deben agregar al Cuadro de herramientas. (Heredado de Package)
QueryClose(Boolean)	Se llama para preguntar al paquete si se puede cerrar el shell. (Heredado de Package)
RegisterEditorFactory(IVsEditorFactory)	Registra un generador de editores con Visual Studio. (Heredado de Package)
RegisterProjectFactory(IVsProjectFactory)	Registra un generador de proyectos en Visual Studio. (Heredado de Package)
RemoveService(Type)	Quita un servicio asincrónico registrado con este paquete.
RemoveService(Type, Boolean)	Quita un servicio asincrónico registrado con este paquete.
ShowOptionPage(Type)	Muestra una página especificada de opciones de las herramientas. (Heredado de Package)
ShowToolWindowAsync(Type, Int32, Boolean, CancellationToken)	Muestra de forma asincrónica la ventana de herramientas correspondiente al tipo y el identificador especificados. Si no existe, crea y devuelve uno si create es true o devuelve null si create es false.

Eventos

ToolboxInitialized	Evento generado cada vez que Visual Studio inicializa su Cuadro de herramientas. (Heredado de Package)
ToolboxUpgraded	Evento generado cada vez que Visual Studio actualiza su Cuadro de herramientas. (Heredado de Package)

Implementaciones de interfaz explícitas

IAsyncLoadablePackageInitialize.Initialize(IAsyncServiceProvider, IProfferAsyncService, IAsyncProgressCallback)	Versión asincrónica de SetSite, llamada desde un subproceso b/g.
IAsyncServiceProvider.QueryServiceAsync(Guid)	Obtenga un servicio de inicialización asincrónico que ofrece este paquete.
IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Ejecuta un comando especificado o muestra Ayuda para un comando. (Heredado de Package)
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Consulta el objeto para conocer el estado de uno o más comandos generados por eventos de interfaz de usuario. (Heredado de Package)
IServiceContainer.AddService(Type, Object)	Agrega el servicio especificado al contenedor de servicios de VSPackage. (Heredado de Package)
IServiceContainer.AddService(Type, Object, Boolean)	Agrega el servicio especificado al contenedor de servicios de VSPackage. (Heredado de Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Agrega el servicio especificado al contenedor de servicios de VSPackage. (Heredado de Package)
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Agrega el servicio especificado al contenedor de servicios mediante el ServiceCreatorCallback especificado. (Heredado de Package)
IServiceContainer.RemoveService(Type)	Quita el tipo de servicio especificado del contenedor de servicios. (Heredado de Package)
IServiceContainer.RemoveService(Type, Boolean)	Quita el tipo de servicio especificado del contenedor de servicios y, opcionalmente, promueve la eliminación del servicio para los contenedores de servicios principales. (Heredado de Package)
IServiceProvider.GetService(Type)	Obtiene el servicio del tipo especificado. (Heredado de Package)
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Implementación interna de IServiceProvider. (Heredado de Package)
IVsAsyncToolWindowFactory.CreateToolWindow(Guid, UInt32, Object)	Crea una ventana de herramientas del tipo especificado con el identificador especificado.
IVsAsyncToolWindowFactory.GetToolWindowTitle(Guid, UInt32)	Devuelve la cadena de título que se va a usar para la ventana de herramientas. Si se devuelve null, el nombre de tipo de la ventana de herramientas se usa para el título.
IVsAsyncToolWindowFactory.InitializeToolWindowAsync(Guid, UInt32)	Realiza la inicialización como preparación para crear la ventana de herramientas identificada por toolWindowType.
IVsPackage.Close()	Cierra y desecha el paquete. (Heredado de Package)
IVsPackage.GetAutomationObject(String, Object)	Obtiene un objeto automatización de fácil uso para este paquete. (Heredado de Package)
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Obtiene acceso a las opciones del menú Herramientas y a las páginas de propiedades de los cuadros de diálogo Personalizar cuadro de herramientas. (Heredado de Package)
IVsPackage.QueryClose(Int32)	Se llama a para preguntar al VSPackage si se puede cerrar el shell de Visual Studio. (Heredado de Package)
IVsPackage.ResetDefaults(UInt32)	Restablece los valores predeterminados del Cuadro de herramientas. (Heredado de Package)
IVsPackage.SetSite(IServiceProvider)	Inicializa el VSPackage en el entorno de Visual Studio. (Heredado de Package)
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Carga las opciones de usuario para una solución determinada. (Heredado de Package)
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Lee las opciones del usuario para una solución determinada. (Heredado de Package)
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Guarda opciones del usuario para una solución determinada. (Heredado de Package)
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Escribe opciones del usuario para una solución determinada. (Heredado de Package)
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Obtiene un elemento. (Heredado de Package)
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)	Representa un VSPackage que puede controlar servicios asincrónicos. (Heredado de Package)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Crea una ventana de herramientas del tipo especificado con el identificador especificado. (Heredado de Package)
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Este método implementa la interfaz IVsUserSettings usada para administrar perfiles y para importar/exportar la configuración a archivos XML. (Heredado de Package)
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Recupera la configuración de VSPackage mediante el mecanismo de configuración de Visual Studio cuando un usuario selecciona la opción de importación de la característica Importar/Exportar configuración en el menú Herramientas del IDE. Este método forma parte de la implementación de la interfaz IVsUserSettings usada para administrar perfiles y para importarlos/exportar configuraciones a archivos XML. (Heredado de Package)
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Migrar valores de una versión anterior. (Heredado de Package)
IVsUserSettingsQuery.NeedExport(String, Int32)	Determina si la configuración ha cambiado y se debe volver a exportar. (Heredado de Package)

Métodos de extensión

ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>)	Proffers un servicio implementado por el tipo especificado en un contenedor de servicios asincrónico. Cuando se consulta el servicio por primera vez, se llamará a la creator función. El servicio proffered se promoverá al contenedor de servicios asincrónicos primario.
ProfferService<TService>(IAsyncServiceContainer, Func<CancellationToken,Task<Object>>, Boolean)	Proffers un servicio implementado por el tipo especificado en un contenedor de servicios asincrónico. Cuando se consulta el servicio por primera vez, se llamará a la creator función.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>)	Proffers un servicio implementado por el tipo especificado en un contenedor de servicios asincrónico. Cuando se consulta el servicio por primera vez, se llamará a la creator función. El servicio proffered se promoverá al contenedor de servicios asincrónicos primario.
ProfferService<TService>(IAsyncServiceContainer, Func<Task<Object>>, Boolean)	Proffers un servicio implementado por el tipo especificado en un contenedor de servicios asincrónico. Cuando se consulta el servicio por primera vez, se llamará a la creator función.
QueryService(IServiceProvider, Guid)	Obtiene un servicio expuesto por un proveedor de servicios en función de su GUID de servicio.
QueryService<TService>(IServiceProvider)	Obtiene un servicio expuesto por un proveedor de servicios en función de su tipo de servicio.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider)	Obtiene una interfaz de servicio de un proveedor de servicios de forma asincrónica.
GetServiceAsync<TService,TInterface>(IAsyncServiceProvider, Boolean)	Obtiene una interfaz de servicio de un proveedor de servicios de forma asincrónica.