ERROR

  • 项目

适用于：计算列计算表度量值视觉对象计算

引发错误并显示错误消息。

语法

ERROR(<text>)

parameters

术语 定义
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] [Measure]
黑色 黑色
蓝色 蓝色
灰色 灰色
多 彩色
NA NA
Red Red
Silver 银卡
银色\黑色 银色\黑色
White 白色
Yellow Yellow

由于洋红色不是产品颜色之一，因此不会执行 ERROR 函数。