ERRORERROR

Löst einen Fehler mit einer Fehlermeldung aus.Raises an error with an error message.

SyntaxSyntax

ERROR(<text>)  

ParameterParameters

BegriffTerm DefinitionDefinition
texttext Eine Textzeichenfolge, die eine Fehlermeldung enthält.A text string containing an error message.

RückgabewertReturn value

KeineNone

BemerkungenRemarks

  • Die ERROR-Funktion kann in einem DAX-Ausdruck überall dort platziert werden, wo ein Skalarwert erwartet wird.The ERROR function can be placed in a DAX expression anywhere a scalar value is expected.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Beispiel 1Example 1

Die folgende DAX-Abfrage:The following DAX query:

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.Fails and raises and error message containing "red color encountered".

Beispiel 2Example 2

Die folgende DAX-Abfrage:The following DAX query:

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:Returns the following table:

DimProduct[Color]DimProduct[Color] [Measure][Measure]
SchwarzBlack SchwarzBlack
BlauBlue BlauBlue
GreyGrey GreyGrey
MehrereMulti MehrereMulti
N/VNA Nicht verfügbarNA
RedRed RedRed
SilberSilver SilberSilver
Silver\BlackSilver\Black Silver\BlackSilver\Black
WeißWhite WhiteWhite
GelbYellow GelbYellow

Da Magenta nicht eine der Produktfarben ist, wird die Fehlerfunktion nicht ausgeführt.Because Magenta is not one of the product colors, the ERROR function is not executed.