Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Boolean.Parse — convertir du texte en valeur booléenne

Boolean.Parse convertit en bool un texte représentant True ou False. La casse ainsi que les caractères d’espacement et les caractères NUL en début et en fin de texte sont ignorés. Une entrée invalide provoque une exception au lieu de renvoyer false.

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

Syntaxe

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

Boolean.Parse est une méthode statique de System.Boolean ; bool.Parse désigne la même méthode. .NET 10 propose des surcharges qui acceptent string et ReadOnlySpan<char>. Toutes deux renvoient bool.

Les deux surcharges acceptent un texte qui correspond à TrueString ("True") ou à FalseString ("False"), sans tenir compte de la casse. Elles ignorent les caractères d’espacement et les caractères NUL (U+0000) en début et en fin de texte. NUL n’est pas un caractère d’espacement. Ainsi, " tRuE " produit true. Les chaînes "1", "0", "yes" et le texte vide ne sont pas des valeurs valides.

Un format invalide provoque FormatException, tandis que le passage de null à la surcharge string provoque ArgumentNullException. Le résultat false signifie qu’une valeur a été correctement analysée, et non qu’une erreur s’est produite. Si des entrées invalides sont prévisibles, choisissez Boolean.TryParse : sa valeur de retour indique la réussite et son paramètre out contient la valeur analysée.

Exemples

using System;

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

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

Résultat

True
False
FormatException

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources