Gravando no repositório de configurações do usuário

As configurações do usuário são configurações graváveis como as da caixa de diálogo Ferramentas / Opções , janelas de propriedades e algumas outras caixas de diálogo. Extensões do Visual Studio podem usá-los para armazenar pequenas quantidades de dados. Este passo a passo mostra como adicionar o bloco de notas ao Visual Studio como uma ferramenta externa, lendo e gravando no repositório de configurações do usuário.

Gravando no repositório de configurações do usuário

1. Crie um projeto VSIX chamado UserSettingsStoreExtension e, em seguida, adicione um comando personalizado chamado UserSettingsStoreCommand. Para obter mais informações sobre como criar um comando personalizado, consulte Criando uma extensão com um comando de menu

2. Em UserSettingsStoreCommand.cs, adicione o seguinte usando diretivas:

   using System.Collections.Generic;
   using Microsoft.VisualStudio.Settings;
   using Microsoft.VisualStudio.Shell.Settings;
   

3. Em MenuItemCallback, exclua o corpo do método e obtenha o armazenamento de configurações do usuário, da seguinte maneira:

   private void MenuItemCallback(object sender, EventArgs e)
   {
       SettingsManager settingsManager = new ShellSettingsManager(ServiceProvider);
       WritableSettingsStore userSettingsStore = settingsManager.GetWritableSettingsStore(SettingsScope.UserSettings);
   }
   

4. Agora descubra se o Bloco de Notas já está definido como uma ferramenta externa. Você precisa iterar por todas as ferramentas externas para determinar se a configuração ToolCmd é "Bloco de notas", da seguinte maneira:

   private void MenuItemCallback(object sender, EventArgs e)
   {
       SettingsManager settingsManager = new ShellSettingsManager(ServiceProvider);
       WritableSettingsStore userSettingsStore = settingsManager.GetWritableSettingsStore(SettingsScope.UserSettings);
   
       // Find out whether Notepad is already an External Tool.
       int toolCount = userSettingsStore.GetInt32("External Tools", "ToolNumKeys");
       bool hasNotepad = false;
       CompareInfo Compare = CultureInfo.InvariantCulture.CompareInfo;
       for (int i = 0; i < toolCount; i++)
       {
           if (Compare.IndexOf(userSettingsStore.GetString("External Tools", "ToolCmd" + i), "Notepad", CompareOptions.IgnoreCase) >= 0)
           {
               hasNotepad = true;
               break;
           }
       }
   }
   
   

5. Se o Bloco de Notas não tiver sido definido como uma ferramenta externa, defina-o da seguinte maneira:

   private void MenuItemCallback(object sender, EventArgs e)
   {
       SettingsManager settingsManager = new ShellSettingsManager(ServiceProvider);
       WritableSettingsStore userSettingsStore = settingsManager.GetWritableSettingsStore(SettingsScope.UserSettings);
   
       // Find out whether Notepad is already installed.
       int toolCount = userSettingsStore.GetInt32("External Tools", "ToolNumKeys");
       bool hasNotepad = false;
       CompareInfo Compare = CultureInfo.InvariantCulture.CompareInfo;
       for (int i = 0; i < toolCount; i++)
       {
           if (Compare.IndexOf(userSettingsStore.GetString("External Tools", "ToolCmd" + i), "Notepad", CompareOptions.IgnoreCase) >= 0)
           {
               hasNotepad = true;
               break;
           }
       }
   
       string message = (hasNotepad) ? "Notepad already installed" : "Installing Notepad";
        if (!hasNotepad)
       {
           userSettingsStore.SetString("External Tools", "ToolTitle" + toolCount, "&Notepad");
           userSettingsStore.SetString("External Tools", "ToolCmd" + toolCount, "C:\\Windows\\notepad.exe");
           userSettingsStore.SetString("External Tools", "ToolArg" + toolCount, "");
           userSettingsStore.SetString("External Tools", "ToolDir" + toolCount, "$(ProjectDir)");
           userSettingsStore.SetString("External Tools", "ToolSourceKey" + toolCount, "");
           userSettingsStore.SetUInt32("External Tools", "ToolOpt" + toolCount, 0x00000011);
   
           userSettingsStore.SetInt32("External Tools", "ToolNumKeys", toolCount + 1);
       }
   }
   

6. Testa o código. Lembre-se de que ele adiciona o bloco de notas como uma ferramenta externa, então você deve reverter o registro antes de executá-lo uma segunda vez.

7. Crie o código e inicie a depuração.

8. No menu Ferramentas, clique em Invocar UserSettingsStoreCommand. Isso adicionará o bloco de notas ao menu Ferramentas .

9. Agora você deve ver o bloco de notas no menu Ferramentas / Opções e clicar em Bloco de notas deve abrir uma instância do bloco de notas.