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
- 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ódigo parcialmente confiáveis.