Attività Error
Interrompe una compilazione e registra un errore in base a un'istruzione condizionale valutata.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività Error.
Parametro |
Descrizione |
|---|---|
Code |
Parametro String facoltativo. Codice da associare all'errore. |
File |
Parametro String facoltativo. Nome del file in cui è contenuto l'errore. Se non viene fornito alcun nome file, viene utilizzato il file in cui è contenuta l'attività Error. |
HelpKeyword |
Parametro String facoltativo. Parola chiave della Guida da associare all'errore. |
Text |
Parametro String facoltativo. Testo dell'errore registrato in MSBuild se il parametro Condition restituisce true. |
Note
L'attività Error consente al progetto MSBuild di inviare il testo dell'errore ai logger e di interrompere l'esecuzione della compilazione.
Se il parametro Condition restituisce true, la compilazione viene interrotta e viene registrato un errore. Se non esiste un parametro Condition, viene registrato l'errore e l'esecuzione della compilazione viene interrotta. Per ulteriori informazioni sulla registrazione, vedere Recupero di log di compilazione con MSBuild.
Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe TaskExtension, che eredita dalla classe Task. Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base TaskExtension.
Esempio
Nell'esempio di codice riportato di seguito viene verificato che siano impostate tutte le proprietà necessarie. In caso contrario, il progetto genera un evento di errore e registra il valore del parametro Text dell'attività Error.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="ValidateCommandLine">
<Error
Text=" The 0 property must be set on the command line."
Condition="'$(0)' == ''" />
<Error
Text="The FREEBUILD property must be set on the command line."
Condition="'$(FREEBUILD)' == ''" />
</Target>
...
</Project>
Vedere anche
Concetti
Recupero di log di compilazione con MSBuild