C# | Convert.ToChar(String, IFormatProvider) Method

This method is used to convert the value of the specified object to its equivalent Unicode character, using the specified culture-specific formatting information. Syntax:

public static char ToChar (object value, IFormatProvider provider);

Parameters:

value: It is an string of length 1 or null.
provider: It is an object that supplies culture-specific formatting information.

Return Value: This method returns a Unicode character which is equivalent to the first and only character in value. Exceptions:

ArgumentNullException: If the value is null.
FormatException: If the length of value is not 1.

Below programs illustrate the use of Convert.ToChar(String, IFormatProvider) Method: Example 1:

csharp

// C# program to demonstrate the
// Convert.ToChar() Method
using System;
using System.Globalization;

class GFG {

// Main Method
public static void Main()
{
    try {
        
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");

        // declaring and initializing
        // String array
        string[] values = {"A", "B", "a", 
                          "b", "x", "z"};

        // calling get() Method
        Console.WriteLine("Converted char value "+
                        "of specified strings: ");
                        
        for (int j = 0; j < values.Length; j++) {
            
            get(values[j], cultures);
        }
    }
    
    catch (FormatException e) {
        
        Console.WriteLine("\n");
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    
    catch (OverflowException e) {
        
        Console.WriteLine("\n");
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}

// Defining get() method
public static void get(string s, 
           CultureInfo cultures)
{

    // converting string to specified char
    char val = Convert.ToChar(s, cultures);

    // display the converted char value
    Console.Write(" {0}, ", val);
}
}

Output:

Converted char value of specified strings: 
 A,  B,  a,  b,  x,  z,

Example 2: For ArgumentNullException

csharp

// C# program to demonstrate the
// Convert.ToChar() Method
using System;
using System.Globalization;
class GFG {

// Main Method
public static void Main()
{
    try {
        
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");

        // declaring and initializing String array
        string[] values = {"A", "B", "a",
                          "b", "x", "z"};

        // calling get() Method
        Console.WriteLine("Converted char value "+
                        "of specified strings: ");
                        
        for (int j = 0; j < values.Length; j++) {
            get(values[j], cultures);
        }
        Console.WriteLine("\n");
        string s = null;

        Console.WriteLine("s is null ");

        // converting string to specified char
        char val = Convert.ToChar(s, cultures);

        // display the converted char value
        Console.Write(" {0}, ", val);
    }
    
    catch (FormatException e) {
        
        Console.WriteLine("\n");
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    
    catch (ArgumentNullException e) {
        
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}

// Defining get() method
public static void get(string s, CultureInfo cultures)
{

    // converting string to specified char
    char val = Convert.ToChar(s, cultures);

    // display the converted char value
    Console.Write(" {0}, ", val);
}
}

Output:

Converted char value of specified strings: 
 A,  B,  a,  b,  x,  z, 

s is null 
Exception Thrown: System.ArgumentNullException

Example 3: For FormatException

csharp

// C# program to demonstrate the
// Convert.ToChar() Method
using System;
using System.Globalization;

class GFG {

// Main Method
public static void Main()
{
    
    try {
        
        // creating object of CultureInfo
        CultureInfo cultures = new CultureInfo("en-US");

        // declaring and initializing String array
        string value1 = "x";
        string value2 = "xyz";

        get(value1, cultures);

        Console.WriteLine("\nlength of value2 is not 1");
        get(value2, cultures);
    }
    
    catch (FormatException e) {
        
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
    
    catch (ArgumentNullException e) {
        
        Console.Write("Exception Thrown: ");
        Console.Write("{0}", e.GetType(), e.Message);
    }
}

// Defining get() method
public static void get(string s, 
           CultureInfo cultures)
{
    // converting string to specified char
    char val = Convert.ToChar(s, cultures);

    // display the converted char value
    Console.WriteLine("string to char value : {0} ", val);
}
}

Output:

string to char value : x 

length of value2 is not 1
Exception Thrown: System.FormatException

Reference:

https://learn.microsoft.com/en-us/dotnet/api/system.convert.tochar?view=netframework-4.7.2#System_Convert_ToChar_System_String_System_IFormatProvider_

C# | Convert.ToChar(String, IFormatProvider) Method

Explore