Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String.Chars Property

Gets the character at a specified character position in the current string.

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

public char this[
	int index
] { get; }

Parameters

index
Type: System.Int32
A character position in the current string.

Property Value

Type: System.Char
The Unicode character at position index.

ExceptionCondition
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.


string str1 = "Test";
for (int ctr = 0; ctr <= str1.Length - 1; ctr++)
   outputBlock.Text += String.Format("{0} ", str1[ctr]);
// The example displays the following output:
//      T e s t         


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";


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

Show:
© 2014 Microsoft