Błąd zadania
Zatrzymuje kompilacji i rejestruje błąd opartą na instrukcji warunkowy ocenione.
Parametry
W tabeli następujących opisano parametry Error zadania.
Parametr |
Opis |
---|---|
Code |
Opcjonalny String parametru. Kod błędu, aby skojarzyć z powodu błędu. |
File |
Opcjonalny String parametru. Nazwa pliku, który zawiera błąd.Jeśli zostanie podana bez nazwy pliku, plik zawierający zadanie błąd będzie używany. |
HelpKeyword |
Opcjonalny String parametru. Słowo kluczowe pomocy do kojarzenia z powodu błędu. |
Text |
Opcjonalny String parametru. Tekst błędu, MSBuild rejestruje, jeśli Condition ma wartość parametru true. |
Uwagi
Error Zadań pozwala MSBuild projektów wydają rejestratory tekst błędu i zatrzymać wykonywanie kompilacji.
Jeśli Condition ma wartość parametru true, kompilacja zostanie zatrzymana, a błąd jest rejestrowany.Jeśli Condition parametr nie istnieje, błąd jest rejestrowany i zbudować zatrzymuje wykonywanie.Aby uzyskać więcej informacji dotyczących rejestrowania, zobacz Uzyskiwanie dzienników kompilacji za pomocą narzędzia MSBuild.
Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z TaskExtension , które sama klasa dziedziczy z Task klasy.Aby uzyskać listę tych dodatkowych parametrów, a ich opisy, zobacz Klasa bazowa TaskExtension.
Przykład
Poniższy przykład kodu sprawdza, czy wszystkie wymagane właściwości są ustawione.Jeśli nie są ustawione, projekt wywołuje zdarzenie błędu i rejestruje wartość Text parametr Error zadania.
<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>
Zobacz też
Koncepcje
Uzyskiwanie dzienników kompilacji za pomocą narzędzia MSBuild