String::Chars Property
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- index
- Type: System::Int32
A 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. Use the System.Globalization::StringInfo class to work with Unicode characters instead of Char objects. For more information, see the "Char Objects and Unicode Characters" section in the String class overview.
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 example demonstrates how you can use this indexer in a routine to validate a string.
Console::Write( "Type a string : " ); String^ myString = Console::ReadLine(); for ( int i = 0; i < myString->Length; i++ ) if ( Uri::IsHexDigit( myString[ i ] ) ) Console::WriteLine( "{0} is a hexadecimal digit.", myString[ i ] ); else Console::WriteLine( "{0} is not a hexadecimal digit.", myString[ i ] ); // The example produces output like the following: // Type a string : 3f5EaZ // 3 is a hexadecimal digit. // f is a hexadecimal digit. // 5 is a hexadecimal digit. // E is a hexadecimal digit. // a is a hexadecimal digit. // Z is not a hexadecimal digit.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.