Warning — Zadanie
Rejestruje ostrzeżenie podczas kompilacji na podstawie ocenianej instrukcji warunkowej.
Parametry
W poniższej tabeli opisano parametry Warning zadania.
| Parametr | Opis |
|---|---|
Code |
Opcjonalny String parametr.Kod ostrzegawczy do skojarzenia z ostrzeżeniem. |
File |
Opcjonalny String parametr.Określa odpowiedni plik, jeśli istnieje. Jeśli plik nie zostanie podany, zostanie użyty plik zawierający zadanie Ostrzeżenie. |
HelpKeyword |
Opcjonalny String parametr.Słowo kluczowe Pomoc do skojarzenia z ostrzeżeniem. Tylko do użytku wewnętrznego. |
HelpLink |
Opcjonalny String parametr.Link do dodatkowych informacji o ostrzeżeniu. |
Text |
Opcjonalny String parametr.Tekst ostrzegawczy, który program MSBuild rejestruje, jeśli Condition parametr zwróci wartość true. |
Uwagi
Zadanie Warning umożliwia projektom MSBuild sprawdzenie obecności wymaganej konfiguracji lub właściwości przed kontynuowaniem następnego kroku kompilacji.
Condition Jeśli parametr Warning zadania zwróci wartość true, wartość Text parametru jest rejestrowana, a kompilacja będzie nadal wykonywana. Condition Jeśli parametr nie istnieje, zostanie zarejestrowany tekst ostrzegawczy. Aby uzyskać więcej informacji na temat rejestrowania, zobacz Uzyskiwanie dzienników kompilacji.
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.
HelpKeyword jest używany przez program Visual Studio do obsługi funkcji pomocy kontekstowej (F1). Możesz użyć HelpLink polecenia , aby skojarzyć stronę pomocy online z komunikatem o błędzie.
Przykład
Poniższy przykład kodu sprawdza właściwości ustawione w wierszu polecenia. Jeśli nie ma ustawionej właściwości, projekt zgłasza zdarzenie ostrzegawcze i rejestruje wartość Text parametru Warning zadania.
<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>