Warning タスク

更新 : 2007 年 11 月

条件付きステートメントの評価に基づいてビルド中の警告をログに記録します。

パラメータ

Warning タスクのパラメータの説明を次の表に示します。

パラメータ

説明

Code

省略可能な String 型のパラメータです。

警告に関連付けられた警告コードです。

HelpKeyword

省略可能な String 型のパラメータです。

警告に関連付けられたヘルプ キーワードです。

Text

省略可能な String 型のパラメータです。

Condition パラメータが true と評価された場合に、MSBuild がログに記録する警告テキストです。

解説

Warning タスクを使用すると、MSBuild プロジェクトで、次のビルド ステップに進む前に、必要な構成やプロパティがあるかどうかをチェックできます。

Warning タスクの Condition パラメータが true と評価された場合、このタスクの Text パラメータの値がログに記録され、ビルド処理が継続されます。Condition パラメータを指定しない場合は、警告テキストがログに記録されます。ログ処理の詳細については、「MSBuild でのログの概要」を参照してください。

使用例

次のコード例では、コマンド ラインで設定されるプロパティが設定されているかどうかをチェックします。プロパティが設定されていない場合、プロジェクトでは警告イベントを発生し、Warning タスクの Text パラメータの値がログに記録されます。

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

参照

概念

MSBuild でのログの概要

MSBuild プロジェクト ファイル スキーマ リファレンス