Convert.ToBoolean Method (String, IFormatProvider)

Converts the specified String representation of a logical value to its Boolean equivalent using the specified culture-specific formatting information.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public static bool ToBoolean(
	string value,
	IFormatProvider provider


Type: System.String
A string that contains the value of either TrueString or FalseString.
Type: System.IFormatProvider
(Reserved) An IFormatProvider interface implementation that supplies culture-specific formatting information.

Return Value

Type: System.Boolean
true if value equals TrueString, or false if value equals FalseString or null.


value is not equal to TrueString or FalseString.

provider is ignored; it does not participate in this operation.

If you prefer not to handle an exception if the conversion fails, you can call the Boolean.TryParse method instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.

The following code sample illustrates the use of ToBoolean, taking a String parameter.

public void ConvertStringBoolean(string stringVal)
   bool boolVal = false;

      boolVal = System.Convert.ToBoolean(stringVal);
      if (boolVal)
         outputBlock.Text += String.Format(
            "String was equal to System.Boolean.TrueString.") + "\n";
         outputBlock.Text += String.Format(
            "String was equal to System.Boolean.FalseString.") + "\n";
   catch (System.FormatException)
      outputBlock.Text += String.Format(
         "The string must equal System.Boolean.TrueString " +
         "or System.Boolean.FalseString.") + "\n";

   // A conversion from bool to string will always succeed.
   stringVal = System.Convert.ToString(boolVal);
   outputBlock.Text += String.Format("{0} as a string is {1}",
      boolVal, stringVal) + "\n";


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.