Error 工作

更新：2007 年 11 月

停止建置並根據評估的條件陳述式記錄錯誤。

參數

下列表格說明 Error 工作的參數。

參數	說明
Code	選擇性 String 參數。 與錯誤關聯的錯誤程式碼。
HelpKeyword	選擇性 String 參數。 與錯誤關聯的說明關鍵字。
Text	選擇性 String 參數。 Condition 參數評估為 true 時，MSBuild 所記錄的錯誤文字。

備註

Error 工作可以讓 MSBuild 專案對記錄器發出錯誤文字並停止建置的執行。

如果 Condition 參數評估為 true，便會停止建置並記錄錯誤。如果沒有 Condition 參數，便會記錄錯誤，並停止建置的執行。如需記錄的詳細資訊，請參閱 MSBuild 中記錄的概觀。

範例

下列的程式碼範例會確認所有必要的屬性都已設定。如果沒有設定這些屬性，專案便會發出錯誤事件，並記錄 Error 工作的 Text 參數值。

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

請參閱

概念

MSBuild 中記錄的概觀

其他資源

MSBuild 工作參考