Convert.ToChar Method (String)

 

Converts the first character of a specified string to a Unicode character.

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

Public Shared Function ToChar (
	value As String
) As Char

Parameters

value
Type: System.String

A string of length 1.

Return Value

Type: System.Char

A Unicode character that is equivalent to the first and only character in value.

Exception Condition
ArgumentNullException

value is null.

FormatException

The length of value is not 1.

value must be a string that contains a single character.

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 example converts each element in a string array to a Char value.

Dim nullString As String = Nothing
Dim strings() As String = { "A", "This", vbTab, nullString }
Dim result As Char
For Each strng As String In strings
   Try
      result = Convert.ToChar(strng)
      Console.WriteLine("'{0}' converts to '{1}'.", strng, result)
   Catch e As FormatException
      Console.WriteLine("'{0}' is not in the correct format for conversion to a Char.", _
                        strng)
   Catch e As ArgumentNullException
      Console.WriteLine("A null string cannot be converted to a Char.")
   End Try
Next
' The example displays the following output:
'       'A' converts to 'A'.
'       'This' is not in the correct format for conversion to a Char.
'       '       ' converts to ' '.
'       A null string cannot be converted to a Char.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: