Compartilhar via


Implementando os geradores de arquivo único

Uma ferramenta personalizada — às vezes chamados de um gerador de arquivo único — pode ser usado para estender a Visual Basic e Visual C# projeto sistemas em Visual Studio. Uma ferramenta personalizada é um componente COM que implementa o IVsSingleFileGenerator interface. Uma ferramenta personalizada usando esta interface, transforma a um único arquivo de entrada em um arquivo de saída simples. O resultado da transformação pode ser o código-fonte, ou qualquer outra de saída que é útil. Dois exemplos de arquivos de código personalizado de ferramenta gerados são o código gerado em resposta às alterações em um designer visual e os arquivos gerados usando WSDL Web Services Description Language ().

Quando uma ferramenta personalizada é carregada, ou o arquivo de entrada é salvo, o sistema de projeto chama o Generate método e passa uma referência a um IVsGeneratorProgress interface de retorno de chamada, na qual a ferramenta pode relatar o seu progresso ao usuário.

O arquivo de saída gerado pela ferramenta personalizada é adicionado ao projeto com uma dependência de arquivo de entrada. O sistema de projeto determina automaticamente o nome do arquivo de saída, com base na seqüência de caracteres retornada pela implementação da ferramenta personalizada do DefaultExtension.

Uma ferramenta personalizada deve implementar a IVsSingleFileGenerator interface. Opcionalmente, oferecer suporte a ferramentas personalizadas a IObjectWithSite interface para recuperar informações de origem diferente, por exemplo, o arquivo de entrada. Em qualquer caso, antes de usar uma ferramenta personalizada, você deve registrá-lo com o sistema ou do Visual Studio registro local. Para obter mais informações sobre como registrar ferramentas personalizadas, consulte Registrando os geradores de arquivo único.

Consulte também

Conceitos

Determinando o Namespace padrão

Expondo os tipos de Designers visuais