attività Warning

  • Articolo

Registra un avviso durante una compilazione in base a un'istruzione condizionale valutata.

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività Warning.

Parametro Descrizione
Code Parametro String facoltativo.

Il codice di avviso da associare all'avviso.
File Parametro String facoltativo.

Specifica il file pertinente, se presente. Se non viene indicato alcun file, verrà usato il file contenente l'attività Warning.
HelpKeyword Parametro String facoltativo.

Parola chiave della Guida da associare all'avviso. Solo per uso interno.
HelpLink Parametro String facoltativo.

Collegamento ad altre informazioni sull'avviso.
Text Parametro String facoltativo.

Testo dell'avviso registrato da MSBuild se il Condition parametro restituisce true.

Osservazioni:

L'attività Warning consente ai progetti MSBuild di verificare la presenza di una configurazione o di una proprietà necessaria prima di procedere con il passaggio di compilazione successivo.

Se il parametro Condition dell'attività Warning restituisce true, verrà registrato il valore del parametro Text e l'esecuzione della compilazione continua. Se non esiste un parametro Condition, viene registrato il testo dell'avviso. Per altre informazioni sulla registrazione, vedere Recupero di log di compilazione.

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

HelpKeyword viene usato da Visual Studio per supportare la funzionalità della Guida contestuale (F1). È possibile utilizzare HelpLink per associare una pagina della Guida online a un messaggio di errore.

Esempio

Nell'esempio di codice seguente viene verificata la presenza di proprietà impostate nella riga di comando. Se non sono presenti proprietà impostate, il progetto genera un evento di avviso e registra il valore del parametro Text dell'attività Warning.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Warning
            Text=" The 0 property was not set on the command line."
            Condition="'$(0)' == ''" />
        <Warning
            Text=" The FREEBUILD property was not set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Vedi anche