Boolean.TryParse メソッド

定義

オーバーロード

TryParse(ReadOnlySpan<Char>, Boolean)

論理値の指定したスパン表現を、等価の Boolean に変換します。Tries to convert the specified span representation of a logical value to its Boolean equivalent.

TryParse(String, Boolean)

論理値の指定した文字列形式を等価の Boolean に変換します。Tries to convert the specified string representation of a logical value to its Boolean equivalent.

TryParse(ReadOnlySpan<Char>, Boolean)

論理値の指定したスパン表現を、等価の Boolean に変換します。Tries to convert the specified span representation of a logical value to its Boolean equivalent.

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

パラメーター

value
ReadOnlySpan<Char>

変換する値を表す文字を含むスパン。A span containing the characters representing the value to convert.

result
Boolean

変換が成功した場合は、このメソッドから戻るときに、truevalue と等しければ TrueStringfalsevalue と等しければ FalseString が格納されます。When this method returns, if the conversion succeeded, contains true if value is equal to TrueString or false if value is equal to FalseString. 変換に失敗した場合は、false を格納します。If the conversion failed, contains false. valuenull であるか、TrueString または FalseString のいずれかのフィールドの値と等しくない場合、変換は失敗します。The conversion fails if value is null or is not equal to the value of either the TrueString or FalseString field.

戻り値

true が正常に変換された場合は value。それ以外の場合は falsetrue if value was converted successfully; otherwise, false.

TryParse(String, Boolean)

論理値の指定した文字列形式を等価の Boolean に変換します。Tries to convert the specified string representation of a logical value to its Boolean equivalent.

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

パラメーター

value
String

変換する値が含まれている文字列。A string containing the value to convert.

result
Boolean

変換が成功した場合は、このメソッドから戻るときに、truevalue と等しければ TrueStringfalsevalue と等しければ FalseString が格納されます。When this method returns, if the conversion succeeded, contains true if value is equal to TrueString or false if value is equal to FalseString. 変換に失敗した場合は、false を格納します。If the conversion failed, contains false. valuenull であるか、TrueString または FalseString のいずれかのフィールドの値と等しくない場合、変換は失敗します。The conversion fails if value is null or is not equal to the value of either the TrueString or FalseString field.

戻り値

true が正常に変換された場合は value。それ以外の場合は falsetrue if value was converted successfully; otherwise, false.

次の例では、TryParse メソッドを呼び出して、文字列の配列を解析します。The following example calls the TryParse method to parse an array of strings. 解析操作が成功するのは、解析対象の文字列が "True" (TrueString フィールドの値) または "False" (FalseString フィールドの値) で、大文字と小文字を区別しない比較の場合だけです。Note that the parse operation succeeds only if the string to be parsed is "True" (the value of the TrueString field) or "False" (the value of the FalseString field) in a case-insensitive comparison.

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

注釈

TryParse メソッドは、Parse メソッドに似ていますが、変換に失敗した場合に TryParse メソッドが例外をスローしない点が異なります。The TryParse method is like the Parse method, except the TryParse method does not throw an exception if the conversion fails.

value パラメーターの先頭または末尾に空白文字を使用できます。The value parameter can be preceded or followed by white space. この比較では、序数と大文字と小文字は区別されません。The comparison is ordinal and case-insensitive.

こちらもご覧ください

適用対象