Suporte para categorias de configurações
Uma categoria de configuração consiste em um grupo de opções personalizar o ambiente de desenvolvimento integrado (IDE). Por exemplo, as configurações podem controlar o layout de Visual Studio windows e o conteúdo dos menus. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.
Sobre o Ferramentas menu do botão Import and Export Settings para iniciar o Import and Export Settings Wizard. O assistente oferece três opções: exportar, importar ou redefinir suas configurações. Por exemplo, selecionando exportar, abre o Escolha configurações de exportação página do assistente.
O controle de árvore no painel de navegação desta página lista de categorias. Uma categoria é um grupo de configurações relacionadas que aparecem como um "ponto de configurações personalizadas", ou seja, como uma caixa de seleção. Você pode usar essas caixas de seleção para selecionar as categorias para persistir em um arquivo .vsettings. O assistente permite que você nomeie o arquivo .vsettings e especifique o seu caminho.
Dica
As configurações salvas ou restauradas como uma categoria e nomes de configuração individual não são exibidos no assistente.
A estrutura de pacote gerenciado (MPF) oferece suporte a criação de categorias de configurações com um mínimo de código adicional.
Você cria um VSPackage para fornecer um recipiente para a categoria por subclassificação o Package classe.
Você cria a categoria propriamente dito, derivando-lo do DialogPage classe.
Conectar-se os dois com o ProvideProfileAttribute.
Suporte para categorias de configurações
O Package classe fornece suporte para a criação de categorias. O DialogPage classe implementa uma categoria. A implementação padrão do DialogPage oferece suas propriedades públicas a um usuário como uma categoria. Para obter mais informações, consulte Passo a passo: Criando uma categoria de configurações.
O DialogPage classe implementa IProfileManager, que fornece a persistência para páginas de opções e configurações do usuário. O LoadSettingsFromXml e SaveSettingsToXml métodos persistirem configurações em um vssettings que o arquivo Visual Studio fornece como um IVsSettingsReader ou IVsSettingsWriter, respectivamente. O ResetSettings método redefine as configurações para seus valores padrão.
O DialogPage classe fornece uma implementação da LoadSettingsFromXml método que lê os pares nome-valor do xml do feed e usa a reflexão para descobrir as propriedades públicas a DialogPage classe derivada. Propriedades que possuem nomes que coincidem com os pares nome-valor recebem os valores correspondentes.
A implementação padrão do SaveSettingsToXml usa a reflexão para descobrir as propriedades públicas a DialogPage classe derivada e grava os valores e nomes de propriedades do feed XML como pares nome-valor.
Caminho de registro de categoria de configurações
O caminho do registro da categoria configurações é determinado pela combinação ApplicationRegistryRoot, a palavra, UserSettings, a categoria de configurações e o nome do ponto de configurações personalizadas. Os nomes da categoria de configurações e ponto de configurações personalizadas são Unidos e separados por um sublinhado para formar o nome canônico, não traduzido que aparece no registro. Por exemplo, se a categoria de configurações é "My Category", as configurações personalizadas do ponto de nome "My Settings" e o HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp de ApplicationRegistryRoot e a categoria de configurações tem a chave do registro, as configurações de Category_My de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\UserSettings\My.
Dica
O nome canônico não aparece em uma interface de usuário (UI).Ele é usado para associar um nome legível à categoria de configurações, muito semelhante a um identificador programático (ProgID).
Atributo de categoria de configurações
O ProvideProfileAttribute determina o mapeamento das categorias a pontos de configurações personalizadas do Import and Export Settings Wizard associando-se em uma categoria com o VSPackage que fornece a ele. Considere o fragmento de código a seguir:
<ProvideProfile(GetType(OptionsPageGeneral), "My Category", "My Settings", 106, 107, True, DescriptionResourceID:=108),
Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")>
Public Class MyPackage
Inherits Package
[ProvideProfile(typeof(OptionsPageGeneral),"My Category", "My Settings", 106, 107, true, DescriptionResourceID = 108)]
[Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")]
public class MyPackage : Package
Identificação do recurso 106 mapeia para "My Category", 107 às "Minhas configurações" e 108 "Várias opções". Isso declara que MyPackage fornece a categoria, minhas configurações de Category_My. A categoria é fornecida pelo OptionsPageGeneral classe, que deve implementar IProfileManager. As configurações nessa categoria estão as propriedades públicas da OptionsPageGeneral classe.
No Import and Export Settings Wizard, o ponto de configurações tem o nome, minhas configurações. Quando o ponto de configurações é selecionado, a descrição, Várias opções de, é exibida. O nome do ponto de configurações e a descrição são tiradas da recursos de seqüência de caracteres localizada.
Consulte também
Tarefas
Passo a passo: Criando uma página de opções
Conceitos
Exemplos de extensibilidade de Visual Studio
Personalizando configurações de desenvolvimento no Visual Studio