ERROR

  • Artikel

Löst einen Fehler mit einer Fehlermeldung aus.

Syntax

ERROR(<text>)

Parameter

Begriff Definition
text Eine Textzeichenfolge, die eine Fehlermeldung enthält.

Rückgabewert

Keine

Bemerkungen

  • Die ERROR-Funktion kann in einem DAX-Ausdruck überall dort platziert werden, wo ein Skalarwert erwartet wird.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.

Beispiel 1

Die folgende DAX-Abfrage:

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]

schlägt fehl und löst eine Fehlermeldung aus, die „rote Farbe gefunden“ enthält.

Beispiel 2

Die folgende DAX-Abfrage:

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]

Gibt die folgende Tabelle zurück:

DimProduct[Color] [Measure]
Schwarz Schwarz
Blau Blau
Grey Grey
Mehrere Mehrere
Nicht verfügbar Nicht verfügbar
Red Red
Silber Silber
Silver\Black Silver\Black
White White
Gelb Gelb

Da Magenta nicht eine der Produktfarben ist, wird die Fehlerfunktion nicht ausgeführt.