Ler em inglês

Compartilhar via


Boolean.TryParse Método

Definição

Sobrecargas

TryParse(ReadOnlySpan<Char>, Boolean)

Tenta converter a representação de intervalo especificada de um valor lógico em seu Boolean equivalente.

TryParse(String, Boolean)

Tenta converter a representação de cadeia de caracteres especificada de um valor lógico em seu Boolean equivalente.

TryParse(ReadOnlySpan<Char>, Boolean)

Origem:
Boolean.cs
Origem:
Boolean.cs
Origem:
Boolean.cs

Tenta converter a representação de intervalo especificada de um valor lógico em seu Boolean equivalente.

public static bool TryParse(ReadOnlySpan<char> value, out bool result);

Parâmetros

value
ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam o valor a ser convertido.

result
Boolean

Quando esse método é retornado, caso a conversão seja bem-sucedida, contém true, se value for igual a TrueString, ou false, se value for igual a FalseString. Caso a conversão falhe, contém false. A conversão falhará se value for null ou não for igual ao valor do campo TrueString ou FalseString.

Retornos

true caso value tenha sido convertido com êxito; do contrário, false.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1

TryParse(String, Boolean)

Origem:
Boolean.cs
Origem:
Boolean.cs
Origem:
Boolean.cs

Tenta converter a representação de cadeia de caracteres especificada de um valor lógico em seu Boolean equivalente.

public static bool TryParse(string value, out bool result);
public static bool TryParse(string? value, out bool result);

Parâmetros

value
String

Uma cadeia de caracteres que contém o valor a ser convertido.

result
Boolean

Quando esse método é retornado, caso a conversão seja bem-sucedida, contém true, se value for igual a TrueString, ou false, se value for igual a FalseString. Caso a conversão falhe, contém false. A conversão falhará se value for null ou não for igual ao valor do campo TrueString ou FalseString.

Retornos

true caso value tenha sido convertido com êxito; do contrário, false.

Exemplos

O exemplo a seguir chama o TryParse método para analisar uma matriz de cadeias de caracteres. Observe que a operação de análise terá êxito somente se a cadeia de caracteres a ser analisada for "True" (o valor do TrueString campo) ou "False" (o valor do FalseString campo) em uma comparação que não diferencia maiúsculas de minúsculas.

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { null, String.Empty, "True", "False",
                          "true", "false", "    true    ", "0",
                          "1", "-1", "string" };
      foreach (var value in values) {
         bool flag;
         if (Boolean.TryParse(value, out flag))
            Console.WriteLine("'{0}' --> {1}", value, flag);
         else
            Console.WriteLine("Unable to parse '{0}'.",
                              value == null ? "<null>" : value);
      }
   }
}
// The example displays the following output:
//       Unable to parse '<null>'.
//       Unable to parse ''.
//       'True' --> True
//       'False' --> False
//       'true' --> True
//       'false' --> False
//       '    true    ' --> True
//       Unable to parse '0'.
//       Unable to parse '1'.
//       Unable to parse '-1'.
//       Unable to parse 'string'.

Comentários

O TryParse método é como o Parse método , exceto que o TryParse método não gera uma exceção se a conversão falhar.

O value parâmetro pode ser precedido ou seguido por espaço em branco. A comparação é ordinal e não diferencia maiúsculas de minúsculas.

Confira também

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0