Package Classe

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

Definição

Namespace:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.14.0.dll

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Assembly:

Fornece uma implementação gerenciada das interfaces necessárias para criar um VSPackage totalmente funcional.

public ref class Package abstract : IServiceProvider, Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget, Microsoft::VisualStudio::OLE::Interop::IServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsPackage, Microsoft::VisualStudio::Shell::Interop::IVsPersistSolutionOpts, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider, Microsoft::VisualStudio::Shell::Interop::IVsToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsUserSettings, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsMigration, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsQuery, System::ComponentModel::Design::IServiceContainer

public ref class Package abstract : IServiceProvider, Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget, Microsoft::VisualStudio::OLE::Interop::IServiceProvider, Microsoft::VisualStudio::Shell::Interop::IVsPackage, Microsoft::VisualStudio::Shell::Interop::IVsPersistSolutionOpts, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider, Microsoft::VisualStudio::Shell::Interop::IVsToolboxItemProvider2, Microsoft::VisualStudio::Shell::Interop::IVsToolWindowFactory, Microsoft::VisualStudio::Shell::Interop::IVsUserSettings, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsMigration, Microsoft::VisualStudio::Shell::Interop::IVsUserSettingsQuery, System::ComponentModel::Design::IServiceContainer

[Microsoft.VisualStudio.Shell.PackageRegistration]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Package : IServiceProvider, Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget, Microsoft.VisualStudio.OLE.Interop.IServiceProvider, Microsoft.VisualStudio.Shell.Interop.IVsPackage, Microsoft.VisualStudio.Shell.Interop.IVsPersistSolutionOpts, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider, Microsoft.VisualStudio.Shell.Interop.IVsToolWindowFactory, Microsoft.VisualStudio.Shell.Interop.IVsUserSettings, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsMigration, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsQuery, System.ComponentModel.Design.IServiceContainer

[Microsoft.VisualStudio.Shell.PackageRegistration]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Package : IServiceProvider, Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget, Microsoft.VisualStudio.OLE.Interop.IServiceProvider, Microsoft.VisualStudio.Shell.Interop.IVsPackage, Microsoft.VisualStudio.Shell.Interop.IVsPersistSolutionOpts, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider, Microsoft.VisualStudio.Shell.Interop.IVsToolboxItemProvider2, Microsoft.VisualStudio.Shell.Interop.IVsToolWindowFactory, Microsoft.VisualStudio.Shell.Interop.IVsUserSettings, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsMigration, Microsoft.VisualStudio.Shell.Interop.IVsUserSettingsQuery, System.ComponentModel.Design.IServiceContainer

[<Microsoft.VisualStudio.Shell.PackageRegistration>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Package = class
    interface IVsPackage
    interface IServiceProvider
    interface IOleCommandTarget
    interface IVsPersistSolutionOpts
    interface IServiceContainer
    interface IServiceProvider
    interface IVsUserSettings
    interface IVsUserSettingsMigration
    interface IVsUserSettingsQuery
    interface IVsToolWindowFactory
    interface IVsToolboxItemProvider

[<Microsoft.VisualStudio.Shell.PackageRegistration>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Package = class
    interface IVsPackage
    interface IServiceProvider
    interface IOleCommandTarget
    interface IVsPersistSolutionOpts
    interface IServiceContainer
    interface IServiceProvider
    interface IVsUserSettings
    interface IVsUserSettingsMigration
    interface IVsUserSettingsQuery
    interface IVsToolWindowFactory
    interface IVsToolboxItemProvider
    interface IVsToolboxItemProvider2

Public MustInherit Class Package
Implements IOleCommandTarget, IServiceContainer, IServiceProvider, IServiceProvider, IVsPackage, IVsPersistSolutionOpts, IVsToolboxItemProvider, IVsToolWindowFactory, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery

Public MustInherit Class Package
Implements IOleCommandTarget, IServiceContainer, IServiceProvider, IServiceProvider, IVsPackage, IVsPersistSolutionOpts, IVsToolboxItemProvider, IVsToolboxItemProvider2, IVsToolWindowFactory, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery

Herança

Object

Package

Derivado

Microsoft.VisualStudio.Modeling.Shell.ModelingPackage

Microsoft.VisualStudio.Shell.AsyncPackage

Microsoft.VisualStudio.Shell.ExtensionPointPackage

Atributos

PackageRegistrationAttribute ComVisibleAttribute

Implementações

IOleCommandTarget IServiceProvider IVsPackage IVsPersistSolutionOpts IVsToolboxItemProvider IVsToolWindowFactory IVsUserSettings IVsUserSettingsMigration IVsUserSettingsQuery IServiceContainer IServiceProvider IVsToolboxItemProvider2

Comentários

A Package classe fornece uma implementação gerenciada de várias das interfaces VSIP mais úteis. Você pode criar a funcionalidade básica de um VSPackage com código relativamente pequeno derivando da Package classe, substituindo alguns de seus métodos e anexando classes de atributo de registro. A Package classe não fornece suporte de registro direto, mas pode usar classes de atributo para fornecer as informações de Registro necessárias para ferramentas externas, como RegPkg.exe.

A Package classe oferece os seguintes serviços por padrão. (Você pode substituí-los solicitando o VSPackage IServiceContainer , removendo-os e adicionando seus próprios serviços em seu lugar.)

• Package

  O pacote oferece a si próprio como um serviço.

• IServiceContainer

  Fornece a capacidade de adicionar e remover serviços. Qualquer serviço adicionado com "promover" definido como true é proffered ao Visual Studio por meio de IProfferService . Isso torna o serviço global para todos os VSPackages no Visual Studio. (Esse serviço estará disponível somente se o VSPackage já tiver sido carregado.)

Além desses serviços, Package o usa a arquitetura de serviço do Visual Studio para fornecer acesso a qualquer serviço disponível por meio do provedor de serviços global.

Construtores

Package()

Inicializa uma nova instância de Package.

Propriedades

ApplicationRegistryRoot	Obtém a chave do registro raiz do hive do registro do Visual Studio atual.
UserDataPath	Obtém o caminho para o armazenamento de dados do usuário para o Visual Studio.
UserLocalDataPath	Obtém o caminho para o armazenamento de dados do usuário local para o Visual Studio.
UserRegistryRoot	Obtém uma chave do registro que pode ser usada para armazenar dados do usuário.
Zombied	Obtém um valor que indica se o pacote no processo de desligamento.

Métodos

AddOptionKey(String)	Adiciona um nome de chave de opção de usuário na lista de chaves de opção.
CreateInstance(Guid, Guid, Type)	Cria o objeto COM especificado usando o objeto CLSID do Registro local do Visual Studio.
CreateTool(Guid)	Permite que classes derivadas forneçam uma implementação, se necessário.
CreateToolWindow(Guid, Int32)	Cria uma janela de ferramentas do tipo especificado com a ID especificada.
CreateToolWindow(Type, Int32)	Cria uma janela de ferramentas do tipo especificado com a ID especificada.
CreateToolWindow(Type, Int32, Object)	Cria uma janela de ferramenta do tipo especificado com a ID especificada.
CreateToolWindow(Type, Int32, UInt32)	Cria uma janela de ferramentas do tipo especificado com a ID especificada.
CreateToolWindow(Type, Int32, UInt32, Object, Guid)	Cria uma janela de ferramenta do tipo especificado com a ID especificada. Esse é o único método que deve chamar IVsUiShell. CreateToolWindow ()
Dispose(Boolean)	Libera os recursos usados pelo objeto Package.
FindToolWindow(Type, Int32, Boolean)	Obtém a janela de ferramentas correspondente ao tipo e à ID especificados.
FindWindowPane(Type, Int32, Boolean)	Obtém o painel de janela correspondente ao tipo e à ID especificados e, se nenhum painel de janela desse tipo existir, criará um se for instruído a fazê-lo.
GetAutomationObject(String)	Obtém o objeto de automação para o VSPackage.
GetDialogPage(Type)	Obtém a página de diálogo solicitada.
GetGlobalService(Type)	Obtém um serviço proffered globalmente pelo Visual Studio ou um de seus pacotes.Isso é o mesmo que chamar GetService () em uma instância de um pacote que proffers nenhum próprio serviço.
GetOutputPane(Guid, String)	Obtém a janela de saída solicitada.
GetProviderLocale()	Retorna a localidade associada a este provedor de serviços.
GetService(Type)	Obtém serviços baseados em tipo do contêiner do serviço VSPackage.
GetToolboxItemData(String, DataFormats+Format)	Obtém o conteúdo do formato de dados para a ID de item da caixa de ferramentas e o formato de dados especificados.
GetToolboxItemDataAsync(String, DataFormats+Format)
Initialize()	Chamado quando o VSPackage é carregado pelo Visual Studio.
InstantiateToolWindow(Type)
InstantiateToolWindow(Type, Object)	Construir uma janela de ferramentas do tipo especificado.
IsExperimentalInstance(IServiceProvider)
IsLocalService(Type)	Determina se o tipo de serviço especificado pode ser recuperado sem a necessidade de uma transição RPC para o thread da interface do usuário.
OnLoadOptions(String, Stream)	Invocado pela classe de pacote quando há opções a serem lidas do arquivo de solução.
OnSaveOptions(String, Stream)	Invocado pela Package classe quando há opções a serem salvas no arquivo de solução.
ParseToolboxResource(TextReader, Guid)	Analisa um recurso de texto inserido do formato apropriado para obter informações sobre quais itens devem ser adicionados à caixa de ferramentas.
ParseToolboxResource(TextReader, ResourceManager)	Analisa um recurso de texto inserido do formato apropriado para obter informações sobre quais itens devem ser adicionados à caixa de ferramentas.
QueryClose(Boolean)	Chamado para solicitar o pacote se o Shell puder ser fechado.
RegisterEditorFactory(IVsEditorFactory)	Registra uma fábrica de editor com o Visual Studio.
RegisterProjectFactory(IVsProjectFactory)	Registra uma fábrica de projetos com o Visual Studio.
ShowOptionPage(Type)	Exibe uma página de opções de ferramentas especificadas.

Eventos

ToolboxInitialized	Evento gerado sempre que o Visual Studio inicializa sua caixa de ferramentas.
ToolboxUpgraded	Evento gerado sempre que o Visual Studio atualiza sua caixa de ferramentas.

Implantações explícitas de interface

IOleCommandTarget.Exec(Guid, UInt32, UInt32, IntPtr, IntPtr)	Executa um comando especificado ou exibe a ajuda para um comando.
IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr)	Consulta o objeto para saber o status de um ou mais comandos gerados pelos eventos da interface do usuário.
IServiceContainer.AddService(Type, Object)	Adiciona o serviço fornecido ao contêiner de serviço do VSPackage.
IServiceContainer.AddService(Type, Object, Boolean)	Adiciona o serviço fornecido ao contêiner de serviço do VSPackage.
IServiceContainer.AddService(Type, ServiceCreatorCallback)	Adiciona o serviço fornecido ao contêiner de serviço do VSPackage.
IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Adiciona o serviço fornecido ao contêiner de serviço por meio do especificado ServiceCreatorCallback .
IServiceContainer.RemoveService(Type)	Remove o tipo de serviço fornecido do contêiner de serviço.
IServiceContainer.RemoveService(Type, Boolean)	Remove o tipo de serviço fornecido do contêiner de serviço e, opcionalmente, promove a remoção do serviço para os contêineres de serviço pai.
IServiceProvider.GetService(Type)	Obtém o serviço do tipo especificado.
IServiceProvider.QueryService(Guid, Guid, IntPtr)	Implementação de IServiceProvider interno.
IVsPackage.Close()	Fecha e descarta o pacote.
IVsPackage.GetAutomationObject(String, Object)	Obtém um objeto amigável para automação para este pacote.
IVsPackage.GetPropertyPage(Guid, VSPROPSHEETPAGE[])	Proffers o acesso às opções do menu ferramentas e às páginas de propriedades das caixas de diálogo Personalizar caixa de ferramentas.
IVsPackage.QueryClose(Int32)	Chamado para perguntar ao VSPackage se o Shell do Visual Studio pode ser fechado.
IVsPackage.ResetDefaults(UInt32)	Redefine os padrões da caixa de ferramentas.
IVsPackage.SetSite(IServiceProvider)	Inicializa o VSPackage no ambiente do Visual Studio.
IVsPersistSolutionOpts.LoadUserOptions(IVsSolutionPersistence, UInt32)	Carrega as opções do usuário para uma determinada solução.
IVsPersistSolutionOpts.ReadUserOptions(IStream, String)	Lê as opções do usuário para uma determinada solução.
IVsPersistSolutionOpts.SaveUserOptions(IVsSolutionPersistence)	Salva as opções do usuário para uma determinada solução.
IVsPersistSolutionOpts.WriteUserOptions(IStream, String)	Grava opções de usuário para uma determinada solução.
IVsToolboxItemProvider.GetItemContent(String, UInt16, IntPtr)	Obtém um item.
IVsToolboxItemProvider2.GetItemContentAsync(String, UInt16)
IVsToolWindowFactory.CreateToolWindow(Guid, UInt32)	Cria uma janela de ferramentas do tipo especificado com a ID especificada.
IVsUserSettings.ExportSettings(String, IVsSettingsWriter)	Esse método implementa a IVsUserSettings interface usada para gerenciar perfis e configurações de importação/exportação para arquivos XML.
IVsUserSettings.ImportSettings(String, IVsSettingsReader, UInt32, Int32)	Recupera a configuração de um VSPackage usando o mecanismo de configurações do Visual Studio quando um usuário seleciona a opção de importação do recurso de configurações de importação/exportação no menu ferramentas do IDE. Esse método faz parte da implementação da IVsUserSettings interface usada para gerenciar perfis e importar/exportar configurações para arquivos XML.
IVsUserSettingsMigration.MigrateSettings(IVsSettingsReader, IVsSettingsWriter, String)	Migra as configurações de uma versão anterior.
IVsUserSettingsQuery.NeedExport(String, Int32)	Determina se as configurações foram alteradas e devem ser exportadas novamente.

Métodos de Extensão

QueryService(IServiceProvider, Guid)	Obtém um serviço exposto por um provedor de serviços com base em seu tipo de serviço.
QueryService<TService>(IServiceProvider)	Obtém um serviço exposto por um provedor de serviços com base em seu tipo de serviço.