Compartilhar via


Registrando geradores de arquivos únicos

Para disponibilizar uma ferramenta personalizada no Visual Studio, você deve registrá-la para que o Visual Studio possa instanciá-la e associá-la a um tipo de projeto específico.

O registro do Visual Studio está em um hive privado, privateregistry.bin. Abra regedit.exe e siga estas instruções para carregar o hive do registro privado para a instalação desejada do Visual Studio: Editando o registro de uma instância do Visual Studio.

Para registrar uma ferramenta personalizada

  1. Registre a DLL da ferramenta personalizada no registro local do Visual Studio (que é carregado em HKEY_LOCAL_MACHINE) ou no registro do sistema, em HKEY_CLASSES_ROOT.

    Por exemplo, aqui estão as informações de registro da ferramenta personalizada MSDataSetGenerator gerenciada, que vem com o Visual Studio:

    [HKEY_LOCAL_MACHINE\{hive}\SOFTWARE\Microsoft\VisualStudio\17.0_**_Config\CLSID\{E76D53CC-3D4F-40A2-BD4D-4F3419755476}]
    @="COM+ class: Microsoft.VSDesigner.CodeGenerator.TypedDataSourceGenerator.DataSourceGeneratorWrapper"
    "InprocServer32"="C:\\WINDOWS\\system32\\mscoree.dll"
    "ThreadingModel"="Both"
    "Class"="Microsoft.VSDesigner.CodeGenerator.TypedDataSourceGenerator.DataSourceGeneratorWrapper"
    "Assembly"="Microsoft.VSDesigner, Version=17.0.0.0, Culture=Neutral, PublicKeyToken=b03f5f7f11d50a3a"
    

    O {hive} é o nome fornecido quando você carregou privateregistry.bin no editor do Registro. A pasta da instância (mostrada aqui como 17.0_**_Config) é específica para uma instalação do Visual Studio em seu computador.

  2. Crie uma chave de registro no hive do Visual Studio desejado em Generators\GUID, onde GUID é o GUID definido pelo sistema ou serviço de projeto da linguagem específica. O nome da chave torna-se o nome programático da ferramenta personalizada. A chave de ferramenta personalizada tem os seguintes valores:

    • (Padrão)

      Optional. Fornece uma descrição amigável da ferramenta personalizada. Esse parâmetro é opcional, mas recomendado.

    • CLSID

      Obrigatório Especifica o identificador da biblioteca de classes do componente COM que implementa IVsSingleFileGenerator.

    • GeneratesDesignTimeSource

      Obrigatório Indica se os tipos de arquivos produzidos por essa ferramenta personalizada são disponibilizados para designers visuais. O valor desse parâmetro precisa ser (zero) 0 para tipos não disponíveis para designers visuais ou (um) 1 para tipos disponíveis para designers visuais.

    Observação

    Você deve registrar a ferramenta personalizada separadamente para cada idioma para o qual deseja que a ferramenta personalizada esteja disponível.

    Por exemplo, o MSDataSetGenerator se registra uma vez para cada idioma:

    [HKEY_LOCAL_MACHINE\{hive}\SOFTWARE\Microsoft\VisualStudio\17.0_**_Config\Generators\{164b10b9-b200-11d0-8c61-00a0c91e29d5}\MSDataSetGenerator]
    @="Microsoft VB Code Generator for XSD"
    "CLSID"="{E76D53CC-3D4F-40a2-BD4D-4F3419755476}"
    "GeneratesDesignTimeSource"=dword:00000001
    
    [HKEY_LOCAL_MACHINE\{hive}\SOFTWARE\Microsoft\VisualStudio\17.0_**_Config\Generators\{fae04ec1-301f-11d3-bf4b-00c04f79efbc}\MSDataSetGenerator]
    @="Microsoft C# Code Generator for XSD"
    "CLSID"="{E76D53CC-3D4F-40a2-BD4D-4F3419755476}"
    "GeneratesDesignTimeSource"=dword:00000001