ToChar Method (String)

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.

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

'Declaration
Public Shared Function ToChar ( _
	value As String _
) As Char

Parameters

value
Type: System.String
A String of length 1 or Nothing.

Return Value

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

ExceptionCondition
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


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft