Método VSProjectItem.RunCustomTool
Executa a ferramenta personalizada associada a um 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
Sub RunCustomTool
Dim instance As VSProjectItem
instance.RunCustomTool()
void RunCustomTool()
void RunCustomTool()
function RunCustomTool()
Comentários
Uma ferramenta personalizada aceita sistema autônomo entrada o arquivo representado por um ProjectItem e grava um novo arquivo cujo nome de arquivo for encontrado na CustomToolOutput propriedade. The RunCustomTool método controla o valor da CustomToolOutput propriedade da seguinte maneira:
Se o CustomToolOutput propriedade fica em branco, o sistema de projeto cria um nome de arquivo apropriado; esse nome de arquivo é baseado no nome dos ProjectItem objeto sobre o 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 o RunCustomTool não executar com êxito (retorna um erro de HRESULT) a CustomToolOutput propriedade é 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 será removida do projeto.
Antes que esse método pode ser chamado, uma ferramenta personalizada deve ser associada a ProjectItem Definindo o CustomTool propriedade das da ProjectItem objeto. The CustomTool propriedade requer o identificador de programa para a ferramenta.
Permissões
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.