Partilhar 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 aos 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 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 propriedade da seguinte maneira:

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

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

  • Se a RunCustomTool não é executado com êxito (retorna um erro na HRESULT), o CustomToolOutput propriedade estiver definida como uma seqüência 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 estar associada a ProjectItem , definindo a CustomTool propriedade do da ProjectItem objeto. O CustomTool propriedade requer o identificador de programa para a ferramenta.

Segurança do .NET Framework

Consulte também

Referência

VSProjectItem Interface

Namespace VSLangProj