Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Boolean.Parse — zamiana tekstu na wartość logiczną

Boolean.Parse zamienia tekst reprezentujący True lub False na bool. Ignoruje wielkość liter oraz białe znaki i znaki NUL na początku i na końcu tekstu. Niepoprawne dane powodują wyjątek zamiast zwrócenia false.

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

Składnia

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

Boolean.Parse to metoda statyczna typu System.Boolean; zapis bool.Parse oznacza tę samą metodę. W .NET 10 dostępne są przeciążenia przyjmujące string oraz ReadOnlySpan<char>. Oba zwracają bool.

Oba przeciążenia akceptują tekst odpowiadający TrueString ("True") lub FalseString ("False"), bez rozróżniania wielkości liter. Pomijają białe znaki oraz znaki NUL (U+0000) na początku i na końcu tekstu. NUL nie jest białym znakiem. Dlatego " tRuE " daje true. Napisy "1", "0", "yes" i pusty tekst nie są poprawnymi wartościami.

Niepoprawny format powoduje FormatException, a null przekazany do przeciążenia string powoduje ArgumentNullException. Wynik false oznacza poprawnie odczytaną wartość, nie błąd. Gdy błędne dane są spodziewane, wybierz Boolean.TryParse: jego wartość zwrotna informuje o powodzeniu, a parametr out zawiera odczytaną wartość.

Przykłady

using System;

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

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

Wynik

True
False
FormatException

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła