Compartilhar via


Método VSProjectItem.RunCustomTool

Executa a ferramenta personalizada associada a uma ProjectItem objeto. Uma ferramenta personalizada é um componente registrado que implementa o IVsSingleFileGenerator interface. Ferramentas personalizadas são semelhantes para designers e editores.

Namespace:  VSLangProj
Assembly:  VSLangProj (em VSLangProj.dll)

Sintaxe

'Declaração
Sub RunCustomTool
void RunCustomTool()
void RunCustomTool()
abstract RunCustomTool : unit -> unit 
function RunCustomTool()

Comentários

Uma ferramenta personalizada aceita como entrada para o arquivo representado por um ProjectItem e grava um novo arquivo cujo nome de arquivo for encontrado na CustomToolOutput propriedade. O RunCustomTool método controla o valor da CustomToolOutput a propriedade da seguinte maneira:

  • Se o CustomToolOutput propriedade estiver em branco, o sistema de projeto cria um nome de arquivo apropriado; o nome do arquivo é baseado no nome da ProjectItem o objeto no qual o RunCustomTool método foi chamado.

  • Se o CustomToolOutput propriedade não está em branco, o sistema de projeto usa o valor existente.

  • Se a RunCustomTool não é executado com êxito (retorna um erro de HRESULT), o CustomToolOutput for definida como uma seqüência de caracteres vazia.

  • O item de projeto criado pelo RunCustomTool método substitui qualquer item de projeto criado anteriormente pela ferramenta personalizada. Se a ferramenta personalizada não é executado com êxito, qualquer item de projeto criado anteriormente pela ferramenta personalizada é removido do projeto.

Antes deste método pode ser chamado, uma ferramenta personalizada deve ser associada a ProjectItem , definindo a CustomTool propriedade da da ProjectItem objeto. O CustomTool propriedade requer o identificador de programa da ferramenta.

Segurança do .NET Framework

Consulte também

Referência

VSProjectItem Interface

Namespace VSLangProj