Condividi tramite


Attività Error

Aggiornamento: novembre 2007

Interrompe una generazione 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.

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 generazione.

Se il parametro Condition restituisce true, la generazione viene interrotta e viene registrato un errore. Se non esiste un parametro Condition, viene registrato l'errore e l'esecuzione della generazione viene interrotta. Per ulteriori informazioni sulla registrazione, vedere Panoramica della registrazione in MSBuild.

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

Panoramica della registrazione in MSBuild

Altre risorse

Riferimenti delle attività MSBuild