WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Boolean.Parse — Text in einen booleschen Wert umwandeln

Boolean.Parse wandelt Text, der True oder False darstellt, in bool um. Groß- und Kleinschreibung sowie Whitespace- und NUL-Zeichen am Anfang und Ende werden ignoriert. Ungültige Eingaben lösen eine Ausnahme aus, statt false zurückzugeben.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

public static bool Parse(string value);
public static bool Parse(ReadOnlySpan<char> value);

Boolean.Parse ist eine statische Methode von System.Boolean; bool.Parse bezeichnet dieselbe Methode. .NET 10 bietet Überladungen, die string und ReadOnlySpan<char> akzeptieren. Beide geben bool zurück.

Beide Überladungen akzeptieren Text, der unabhängig von der Groß- und Kleinschreibung TrueString ("True") oder FalseString ("False") entspricht. Whitespace-Zeichen und NUL-Zeichen (U+0000) am Anfang und Ende werden ignoriert. NUL ist kein Whitespace-Zeichen. Daher ergibt " tRuE " den Wert true. Die Zeichenfolgen "1", "0", "yes" und leerer Text sind keine gültigen Werte.

Ein ungültiges Format löst FormatException aus; wird an die string-Überladung null übergeben, wird ArgumentNullException ausgelöst. Das Ergebnis false bedeutet, dass ein Wert erfolgreich eingelesen wurde, nicht dass ein Fehler aufgetreten ist. Wenn ungültige Eingaben zu erwarten sind, verwende Boolean.TryParse: Der Rückgabewert zeigt den Erfolg an, und der out-Parameter enthält den eingelesenen Wert.

Beispiele

using System;

Console.WriteLine(Boolean.Parse("  tRuE  "));
Console.WriteLine(bool.Parse("FALSE".AsSpan()));

try
{
    Boolean.Parse("1");
}
catch (FormatException)
{
    Console.WriteLine("FormatException");
}

Ergebnis

True
False
FormatException

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen