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)

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.

Aplica-se a

TryParse(String, Boolean)

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);
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á sucesso apenas 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'.
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 pelo fato de o TryParse método não lançar uma exceção se a conversão falhar.

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

Confira também

Aplica-se a