Error 작업

  • 아티클

빌드를 중지하고 평가된 조건부 문에 따라 오류를 기록합니다.

매개 변수

다음 표에서는 Error 작업의 매개 변수에 대해 설명합니다.

매개 변수 Description
Code 선택적 String 매개 변수입니다.

오류와 연결할 오류 코드입니다.
File 선택적 String 매개 변수입니다.

오류가 포함된 파일의 이름입니다. 파일 이름을 제공하지 않으면 오류 작업이 포함된 파일이 사용됩니다.
HelpKeyword 선택적 String 매개 변수입니다.

오류와 연결할 도움말 키워드입니다. 내부 전용.
HelpLink 선택적 String 매개 변수입니다.

오류에 대한 추가 정보에 대한 링크입니다.
Text 선택적 String 매개 변수입니다.

Condition 매개 변수가 true로 평가될 경우 MSBuild가 기록하는 오류 텍스트입니다.

설명

Error 작업을 수행하면 MSBuild 프로젝트에서 로거에 대해 오류 텍스트를 실행하고 빌드 실행을 중지할 수 있습니다.

Condition 매개 변수가 true로 평가될 경우 빌드가 중지되고 오류가 기록됩니다. Condition 매개 변수가 없으면 오류가 기록되고 빌드 실행이 중지됩니다. 로깅에 대한 자세한 내용은 빌드 로그 가져오기를 참조하세요.

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension 기본 클래스를 참조하세요.

HelpKeyword는 상황에 맞는 도움말 기능(F1)을 지원하기 위해 Visual Studio에서 사용됩니다. HelpLink를 사용하여 온라인 도움말 페이지를 오류 메시지와 연결할 수 있습니다.

예시

다음 코드 예제는 모든 필수 속성이 설정되었는지 확인합니다. 설정되지 않은 경우 프로젝트에서는 오류 이벤트를 발생시키고 Error 작업의 Text 매개 변수 값을 기록합니다.

<Project xmlns="http://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>

참고 항목