Boolean.TryParse Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

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

public:
 static bool TryParse(ReadOnlySpan<char> value, [Runtime::InteropServices::Out] bool % result);

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

static member TryParse : ReadOnlySpan<char> * bool -> bool

Public Shared Function TryParse (value As ReadOnlySpan(Of Char), ByRef result As Boolean) As Boolean

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

Boolean

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

TryParse(String, Boolean)

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(System::String ^ value, [Runtime::InteropServices::Out] bool % result);

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

static member TryParse : string * bool -> bool

Public Shared Function TryParse (value As String, ByRef result As Boolean) As Boolean

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

Boolean

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'.

open System

let values = 
    [ null; String.Empty; "True"; "False"
      "true"; "false"; "    true    "; "0"
      "1"; "-1"; "string" ]
for value in values do
    match Boolean.TryParse value with
    | true, flag ->
        printfn $"'{value}' --> {flag}"
    | false, _ ->
        printfn $"""Unable to parse '%s{if value = null then "<null>" else 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'.

Module Example
   Public Sub Main()
      Dim values() As String = { Nothing, String.Empty, "True", "False", 
                                 "true", "false", "    true    ", "0", 
                                 "1", "-1", "string" }
      For Each value In values
         Dim flag As Boolean
         
         If Boolean.TryParse(value, flag) Then
            Console.WriteLine("'{0}' --> {1}", value, flag)
         Else
            Console.WriteLine("Unable to parse '{0}'.", 
                              If(value Is Nothing, "<null>", value))
         End If         
      Next                                     
   End Sub
End Module
' 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

• Parse(String)
• TrueString
• FalseString
• Analisando outras cadeias de caracteres no .NET