Condividi tramite

Metodo VSProjectItem.RunCustomTool

  • Articolo

Esegue lo strumento personalizzato associato a un oggetto ProjectItem. Uno strumento personalizzato è un componente registrato che consente l'implementazione dell'interfaccia IVsSingleFileGenerator. Gli strumenti personalizzati sono simili alle finestre di progettazione e agli editor.

Spazio dei nomi: VSLangProj
Assembly: VSLangProj (in vslangproj.dll)

Sintassi

'Dichiarazione
'Utilizzo

Note

Uno strumento personalizzato accetta come input il file rappresentato da ProjectItem e scrive un nuovo file il cui nome si trova nella proprietà CustomToolOutput. Il metodo RunCustomTool controlla il valore della proprietà CustomToolOutput come illustrato di seguito:

  • Se la proprietà CustomToolOutput è vuota, il sistema del progetto crea un nome file appropriato, basato sul nome dell'oggetto ProjectItem nel quale è stato richiamato il metodo RunCustomTool.

  • Se la proprietà CustomToolOutput non è vuota, il sistema del progetto utilizza il valore esistente.

  • Se il metodo RunCustomTool non viene eseguito correttamente, ovvero restituisce un errore in HRESULT, la proprietà CustomToolOutput viene impostata su una stringa vuota.

  • L'elemento di progetto creato dal metodo RunCustomTool sostituisce qualsiasi elemento di progetto creato in precedenza dallo strumento personalizzato. Se lo strumento personalizzato non viene eseguito correttamente, qualsiasi elemento di progetto creato in precedenza dallo strumento personalizzato viene rimosso dal progetto.

Prima che il suddetto metodo possa essere chiamato, uno strumento personalizzato deve essere associato a ProjectItem tramite l'impostazione della proprietà CustomTool dell'oggetto ProjectItem. La proprietà CustomTool richiede l'identificatore di programma per lo strumento.

Vedere anche

Riferimenti

Interfaccia VSProjectItem
Membri VSProjectItem
Spazio dei nomi VSLangProj