attività Message

  • Articolo

Registra un messaggio durante una compilazione.

Parametri

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

Parametro Descrizione
Importance Parametro String facoltativo.

Specifica l'importanza del messaggio. Il valore di questo parametro può essere high, normal o low. Il valore predefinito è normal.
Text Parametro String facoltativo.

Testo dell'errore da registrare.

Osservazioni:

L'attività Message consente ai progetti MSBuild di inviare messaggi a logger in passaggi diversi del processo di compilazione.

Se il parametro Condition restituisce true, verrà registrato il valore del parametro Text e la compilazione continuerà a essere eseguita. Se il parametro Condition non esiste, verrà registrato il testo del messaggio. Per altre informazioni sulla registrazione, vedere Recupero di log di compilazione.

Per impostazione predefinita, il messaggio viene inviato a tutti i logger registrati. Il parametro Importance viene interpretato dal logger. In genere, un messaggio impostato su high viene inviato quando il livello di dettaglio del logger è impostato su LoggerVerbosity.Minimal o superiore. Un messaggio impostato su low viene inviato quando il livello di dettaglio del logger è impostato su LoggerVerbosity.Detailed.

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.

Esempio

Nell'esempio di codice riportato di seguito i messaggi vengono registrati in tutti i logger registrati.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="DisplayMessages">
        <Message Text="Project File Name = $(MSBuildProjectFile)" />
        <Message Text="Project Extension = $(MSBuildProjectExtension)" />
    </Target>
    ...
</Project>

Vedi anche