This documentation is archived and is not being maintained.

StringBuilder.Chars Property

Gets or sets the character at the specified character position in this instance.

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

public char this [
	int index
] { get; set; }
/** @property */
public char get_Chars (int index)

/** @property */
public void set_Chars (int index, char value)

JScript supports the use of indexed properties, but not the declaration of new ones.



The position of the character.

Property Value

The Unicode character at position index.

Exception typeCondition


index is outside the bounds of this instance while setting a character.


index is outside the bounds of this instance while getting a character.

The index parameter is the position of a character within the StringBuilder. The first character in the string is at index 0. The length of a string is the number of characters it contains. The last accessible character of a StringBuilder instance is at index Length - 1.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0