Partilhar via


Registrando geradores de arquivo único

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 para Visual Studio está em uma colmeia privada, privateregistry.bin. Abra regedit.exe e siga estas instruções para carregar o favo do registo privado para a instalação desejada do Visual Studio: Editar o registo para 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 para a 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 que você forneceu quando carregou privateregistry.bin no editor do Registro, e a pasta de instância (mostrada aqui como 17.0_**_Config) é específica para uma instalação específica do Visual Studio em sua máquina.

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

    • (Padrão)

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

    • CLSID

      Required. Especifica o identificador da biblioteca de classes do componente COM que implementa IVsSingleFileGenerator.

    • GeraFonteEmTempoDeDesign

      Required. 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 registra-se 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