Boolean-Funktion

Gilt für: Canvas-Apps Copilot Studio Desktop flows Modellgesteuerte Apps Power Platform CLI Dataverse Funktionen Power Pages

Konvertieren eines Texts, einer Zahl oder eines dynamischen Werts in einen Boolean Wert.

Beschreibung

Verwenden Sie die Boolean Funktion, um andere Typen in einen Boolean Wert zu konvertieren. Ein Boolean Wert ist wahr, falsch oder leer.

In den meisten Fällen erfolgt die Typkoersion automatisch, und Sie müssen die Boolean Funktion nicht explizit verwenden. Gibt z. B. 1 zurück, If( "true", 1, 0 ) da die Textzeichenfolge "true" automatisch in ein Boolean. Die Boolean Funktion ist nützlich, wenn Sie eine explizite Konvertierung oder einen dynamischen Wert verwenden möchten.

Syntax

Boolean( Text )
Boolean( TextSingleColumnTable )

• Text – Erforderlich. Die zu konvertierende(n) Zeichenfolge(n). Muss eine Version von "true" oder "false" sein, bei der die Groß-/Kleinschreibung nicht beachtet wird. Diese Textzeichenfolgen werden nicht lokalisiert. Leerer und leerer Text werden ebenfalls akzeptiert und in ein Leeres konvertiert. Alle anderen Textzeichenfolgen geben einen Fehler zurück.

Boolean( Zahl )
Boolean( NumberSingleColumnTable )

• Nummer - Erforderlich. Die zu konvertierende(n) Zahl(en). 0 wird in falsch umgewandelt und alle anderen Zahlen werden in wahr umgewandelt. leere Werte werden akzeptiert und in leere Werte umgewandelt.

Boolean( DynamicValue )

• DynamicValue – Erforderlich. Der zu konvertierende dynamische Wert. Zulässige Werte hängen vom dynamischen Anbieter ab. Für JSON werden boolesche JSON-Werte true, false und null akzeptiert, entsprechend zu den Werten true, false und blank in Power Fx. Zeichenfolgen- oder Zahlenwerte werden wie beschrieben akzeptiert für die vorher beschriebenen Zeichenfolge- und Zahl-Überladungen.

Beispiele

Grundlegende Nutzung

Formel	Beschreibung	Result
Boolean( "true" )	Konvertiert den Textwert "true" in einen booleschen Wert.	WAHR
Boolean( "false" )	Konvertiert den Textwert "false" in einen booleschen Wert.	FALSCH
Boolean( "TRUE" )	Konvertiert den Textwert "TRUE" in einen booleschen Wert.	WAHR
Boolean( "TrUe" )	Konvertiert den Textwert "TrUe" in einen booleschen Wert.	WAHR
Boolean( "Wahrheitsgemäß" )	Versucht, die Textzeichenfolge "Truthful" in einen booleschen Wert zu konvertieren, da es sich aber nicht um eine Variation von true und false handelt, bei der die Groß-/Kleinschreibung nicht beachtet wird, wird ein Fehler zurückgegeben.	Fehler (ungültiges Argument)
Boolean( Leer()	Konvertiert den leeren Wert in einen booleschen Wert.	leer
Boolean( 0 )	Konvertiert die Zahl 0 in einen booleschen Wert.	FALSCH
Boolean( 1 )	Konvertiert die Zahl 1 in einen booleschen Wert.	WAHR
Boolean( -1234 )	Konvertiert die Zahl -1234 in einen booleschen Wert.	WAHR

Dynamische Verwendung

Formel	Beschreibung	Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool )	Konvertiert den dynamischen Wert true (json Boolean) in einen booleschen Wert.	WAHR
Boolean( ParseJSON( "{ ""bool"": null }" ).bool )	Konvertiert den dynamischen Wert null (json null) in einen booleschen Wert.	leer
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool )	Versucht, den dynamischen Wert "true" (eine JSON-Zeichenfolge) in einen booleschen Wert zu konvertieren, da er jedoch kein gültiger boolescher Wert in JSON ist, wird ein Fehler zurückgegeben.	Fehler (ungültiges Argument)
Boolean( ParseJSON( "[ true, false, null ]" ).bool )	Versucht, ein Array von booleschen Werten in eine Tabelle mit einer einzelnen Spalte zu konvertieren. Einzelspaltentabellen werden nicht mit dynamischen Werten unterstützt, sondern die Formel ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) oder ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) sollte verwendet werden.	Fehler (ungültiges Argument)

Einspaltige Tabellen

Formel	Beschreibung	Result
Boolean( [ "true", "false", Blank() ]	Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten.	[ wahr, falsch, leer ]
Boolean( [ "true", "falsified" ] )	Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten. Da der zweite Datensatz in dieser Tabelle keine Variante von true und false ist, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird, wird für diesen Datensatz ein Fehler zurückgegeben.	[ wahr, Fehler (ungültiges Argument) ]
Boolean( [ 1, 2, 0 ] )	Konvertiert die einzelne Spaltentabelle von Zahlen in eine einzelne Spaltentabelle mit booleschen Werten.	[ wahr, wahr, falsch ]