Convert.ToChar Method (String)
.NET Framework (current version)
Converts the first character of a specified string to a Unicode character.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.String
A string of length 1.
Return Value
Type: System.CharA 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
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
Show: