Metodo VSProjectItem.RunCustomTool
Aggiornamento: novembre 2007
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
Sub RunCustomTool
Dim instance As VSProjectItem
instance.RunCustomTool()
void RunCustomTool()
void RunCustomTool()
function RunCustomTool()
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.
Autorizzazioni
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.