共用方式為

ERROR

  • 發行項

適用於：匯出數據行計算數據表量值視覺計算

引發錯誤並顯示錯誤訊息。

語法

ERROR(<text>)

參數

術語 定義
text 包含錯誤訊息的文字字串。

傳回值

沒有

言論

  • ERROR 函式可以放在預期純量值的任何位置 DAX 表示式中。

  • 在匯出數據行或數據列層級安全性 （RLS） 規則中使用時，不支援在 DirectQuery 模式中使用此函式。

範例 1

下列 DAX 查詢：

DEFINE
MEASURE DimProduct[Measure] =
        IF(
            SELECTEDVALUE(DimProduct[Color]) = "Red",
            ERROR("red color encountered"),
            SELECTEDVALUE(DimProduct[Color])
        )
EVALUATE SUMMARIZECOLUMNS(DimProduct[Color], "Measure", [Measure])
ORDER BY [Color]

失敗並引發包含「遇到紅色」的錯誤訊息。

範例 2

下列 DAX 查詢：

DEFINE
MEASURE DimProduct[Measure] =
        IF(
            SELECTEDVALUE(DimProduct[Color]) = "Magenta",
            ERROR("magenta color encountered"),
            SELECTEDVALUE(DimProduct[Color])
        )
EVALUATE SUMMARIZECOLUMNS(DimProduct[Color], "Measure", [Measure])
ORDER BY [Color]

傳回下表：

DimProduct[Color] [量值]
黑 黑
藍 藍
灰色 灰色
多 多
那 那
紅 紅
銀 銀
Silver\Black Silver\Black
白 白
黃色 黃色

由於Magenta不是其中一種產品色彩，因此不會執行 ERROR 函式。