다음을 통해 공유


Warning 작업

평가된 조건부 문에 따라 빌드 중에 경고를 로깅합니다.

매개 변수

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

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

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

있는 경우 관련 파일을 지정합니다. 파일을 제공하지 않으면 경고 작업이 포함된 파일이 사용됩니다.
HelpKeyword 선택적 String 매개 변수입니다.

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

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

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

설명

Warning 작업을 통해 MSBuild 프로젝트는 다음 빌드 단계를 계속하기 전에 필수 구성 또는 속성의 존재를 확인할 수 있습니다.

Warning 작업의 Condition 매개 변수가 true로 평가되는 경우 Text 매개 변수 값은 로깅되고 빌드가 계속 실행됩니다. Condition 매개 변수가 없으면 경고 텍스트가 로깅됩니다. 로깅에 대한 자세한 내용은 빌드 로그 가져오기를 참조하세요.

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

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

예시

다음 코드 예제에서는 명령줄에서 설정된 속성을 확인합니다. 설정된 속성이 없는 경우 프로젝트에서는 경고 이벤트를 발생시키고 Warning 작업의 Text 매개 변수 값을 기록합니다.

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

참고 항목