Convert.ToChar Method (String)
[ 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.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type: System.String
A String of length 1 or Nothing.
Return Value
Type: System.CharThe Unicode character equivalent to the first and only character in value.
| Exception | Condition |
|---|---|
| ArgumentNullException | value is Nothing. |
| 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 code sample illustrates the use of ToByte, by attempting to convert a String value to a Char :
Public Sub ConvertStringChar(ByVal stringVal As String) Dim charVal As Char = "a"c ' A string must be one character long to convert to char. Try charVal = System.Convert.ToChar(stringVal) outputBlock.Text &= String.Format("{0} as a char is {1}", _ stringVal, charVal) & vbCrLf Catch exception As System.FormatException outputBlock.Text &= String.Format( _ "The string is longer than one character.") & vbCrLf Catch exception As System.ArgumentNullException outputBlock.Text &= "The string is null." & vbCrLf End Try ' A char to string conversion will always succeed. stringVal = System.Convert.ToString(charVal) outputBlock.Text &= String.Format("The character as a string is {0}", _ stringVal) & vbCrLf End Sub