ToChar Method (String, IFormatProvider)

Convert.ToChar Method (String, IFormatProvider)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Converts the first character of a String to a Unicode character using specified culture-specific formatting information.

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

public static char ToChar(
	string value,
	IFormatProvider provider


Type: System.String
A String of length 1 or null.
Type: System.IFormatProvider
(Reserved) An IFormatProvider interface implementation that supplies culture-specific formatting information.

Return Value

Type: System.Char
The Unicode character equivalent to the first and only character in value.


value is null.


The length of value is not 1.

value must be a string that contains a single character.

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 Char.TryParse method instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.

The following code example converts a String representation of a Char value with the ToChar method, using an IFormatProvider object that displays the type of the format provider for which it is called. The example shows that the format provider is not referenced.

// Example of selected Convert.ToXXX( String, IFormatProvider ) methods.
using System;
using System.Globalization;

public class DummyProvider : IFormatProvider
   private System.Windows.Controls.TextBlock outputBlock;

   public DummyProvider(System.Windows.Controls.TextBlock outputBlock)
      this.outputBlock = outputBlock;

   // Normally, GetFormat returns an object of the requested type
   // (usually itself) if it is able; otherwise, it returns Nothing. 
   public object GetFormat(Type argType)
      // Here, GetFormat displays the name of argType, after removing 
      // the namespace information. GetFormat always returns null.
      string argStr = argType.ToString();
      if (argStr == "")
         argStr = "Empty";
      argStr = argStr.Substring(argStr.LastIndexOf('.') + 1);

      outputBlock.Text += String.Format("{0,-20}", argStr);
      return null;

class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      // Create an instance of IFormatProvider.
      DummyProvider provider = new DummyProvider(outputBlock);
      string format = "{0,-17}{1,-17}{2}";

      // Convert these values using DummyProvider.
      string Int32A = "-252645135";
      string DoubleA = "61680.3855";
      string DayTimeA = "2001/9/11 13:45";

      string BoolA = "True";
      string StringA = "Qwerty";
      string CharA = "$";

      outputBlock.Text += "This example of selected " +
          "Convert.ToXXX( String, IFormatProvider ) \nmethods " +
          "generates the following output. The example displays " +
          "the \nprovider type if the IFormatProvider is called." + "\n";
      outputBlock.Text += "\nNote: For the " +
          "ToBoolean, ToString, and ToChar methods, the \n" +
          "IFormatProvider object is not referenced." + "\n";

      // The format provider is called for the following conversions.
      outputBlock.Text += "\n";
      outputBlock.Text += String.Format(format, "ToInt32", Int32A,
          Convert.ToInt32(Int32A, provider)) + "\n";
      outputBlock.Text += String.Format(format, "ToDouble", DoubleA,
          Convert.ToDouble(DoubleA, provider)) + "\n";
      outputBlock.Text += String.Format(format, "ToDateTime", DayTimeA,
          Convert.ToDateTime(DayTimeA, provider)) + "\n";

      // The format provider is not called for these conversions.
      outputBlock.Text += "\n";
      outputBlock.Text += String.Format(format, "ToBoolean", BoolA,
          Convert.ToBoolean(BoolA, provider)) + "\n";
      outputBlock.Text += String.Format(format, "ToString", StringA,
          Convert.ToString(StringA, provider)) + "\n";
      outputBlock.Text += String.Format(format, "ToChar", CharA,
          Convert.ToChar(CharA, provider)) + "\n";

This example of selected Convert.ToXXX( String, IFormatProvider )
methods generates the following output. The example displays the
provider type if the IFormatProvider is called.

Note: For the ToBoolean, ToString, and ToChar methods, the
IFormatProvider object is not referenced.

NumberFormatInfo    ToInt32          -252645135       -252645135
NumberFormatInfo    ToDouble         61680.3855       61680.3855
DateTimeFormatInfo  ToDateTime       2001/9/11 13:45  9/11/2001 1:45:00 PM

ToBoolean        True             True
ToString         Qwerty           Qwerty
ToChar           $                $

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2017 Microsoft