오류 작업Error Task

빌드를 중지하고 평가된 조건부 문에 따라 오류를 기록합니다.Stops a build and logs an error based on an evaluated conditional statement.

매개 변수Parameters

다음 표에서는 Error 작업의 매개 변수를 설명합니다.The folowing table describes the parameters of the Error task.

매개 변수Parameter 설명Description
Code 선택적 String 매개 변수입니다.Optional String parameter.

오류와 연결할 오류 코드입니다.The error code to associate with the error.
File 선택적 String 매개 변수입니다.Optional String parameter.

오류가 포함된 파일의 이름입니다.The name of the file that contains the error. 파일 이름을 제공하지 않으면 오류 작업이 포함된 파일이 사용됩니다.If no file name is provided, the file containing the Error task will be used.
HelpKeyword 선택적 String 매개 변수입니다.Optional String parameter.

오류와 연결할 도움말 키워드입니다.The Help keyword to associate with the error.
Text 선택적 String 매개 변수입니다.Optional String parameter.

Condition 매개 변수가 true로 평가될 경우 MSBuildMSBuild가 기록하는 오류 텍스트입니다.The error text that MSBuildMSBuild logs if the Condition parameter evaluates to true.

설명Remarks

Error 작업을 수행하면 MSBuildMSBuild 프로젝트에서 로거에 대해 오류 텍스트를 실행하고 빌드 실행을 중지할 수 있습니다.The Error task allows MSBuildMSBuild projects issue error text to loggers and stop build execution.

Condition 매개 변수가 true로 평가될 경우 빌드가 중지되고 오류가 기록됩니다.If the Condition parameter evaluates to true, the build is stopped, and an error is logged. Condition 매개 변수가 없으면 오류가 기록되고 빌드 실행이 중지됩니다.If a Condition parameter does not exist, the error is logged and build execution stops. 로깅에 대한 자세한 내용은 빌드 로그 가져오기를 참조하세요.For more information on logging, see Obtaining Build Logs.

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension Base Class를 참조하세요.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

예제Example

다음 코드 예제는 모든 필수 속성이 설정되었는지 확인합니다.The following code example verifies that all required properties are set. 설정되지 않은 경우 프로젝트에서는 오류 이벤트를 발생시키고 Error 작업의 Text 매개 변수 값을 기록합니다.If they are not set, the project raises an error event, and logs the value of the Text parameter of the Error task.

<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>  

참고 항목See Also

작업 참조 Task Reference
빌드 로그 가져오기Obtaining Build Logs