String.Chars Property
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets the character at a specified character position in the current string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- index
- Type: System.Int32
A character position in the current string.
| Exception | Condition |
|---|---|
| IndexOutOfRangeException | index is greater than or equal to the length of this object or less than zero. |
The index parameter is zero-based.
This property returns the Char object at the position specified by the index parameter. However, a Unicode character might be represented by more than one Char object. Use the System.Globalization.StringInfo class to work with Unicode characters instead of Char objects.
In C#, the Chars property is an indexer. In Visual Basic, it is the default property of the String class. Each Char object in the string can be accessed by using code such as the following.
The following code example demonstrates how you can use the Chars property in a routine to validate a string.
outputBlock.Text += "Type a string : "; string myString = Console.ReadLine(); for (int i = 0; i < myString.Length; i++) if (Uri.IsHexDigit(myString[i])) outputBlock.Text += String.Format("{0} is a hexadecimal digit.", myString[i]) + "\n"; else outputBlock.Text += String.Format("{0} is not a hexadecimal digit.", myString[i]) + "\n";