Komunikat — Zadanie
Rejestruje komunikat podczas kompilacji.
Parametry
W poniższej tabeli opisano parametry Message
zadania.
Parametr | Opis |
---|---|
Importance |
Opcjonalny String parametr.Określa ważność komunikatu. Ten parametr może mieć wartość high , normal lub low . Wartość domyślna to normal . |
Text |
Opcjonalny String parametr.Tekst błędu do zarejestrowania. |
Uwagi
Zadanie Message
umożliwia projektom MSBuild wysyłanie komunikatów do rejestratorów w różnych krokach procesu kompilacji.
Condition
Jeśli parametr zwróci wartość true
, wartość parametru Text
zostanie zarejestrowana, a kompilacja będzie nadal wykonywana. Condition
Jeśli parametr nie istnieje, tekst wiadomości jest rejestrowany. Aby uzyskać więcej informacji na temat rejestrowania, zobacz Uzyskiwanie dzienników kompilacji.
Domyślnie komunikat jest wysyłany do wszystkich zarejestrowanych rejestratorów. Rejestrator interpretuje Importance
parametr . Zazwyczaj komunikat ustawiony na high
jest wysyłany, gdy czasownik rejestratora jest ustawiony na LoggerVerbositywartość .Minimal
lub nowszy. Komunikat ustawiony na low
jest wysyłany, gdy czasownik rejestratora jest ustawiony na LoggerVerbosity.Detailed
.
Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.
Przykład
Poniższy przykład kodu rejestruje komunikaty do wszystkich zarejestrowanych rejestratorów.
<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>