Export (0) Print
Expand All
2 out of 7 rated this helpful - Rate this topic

String.Chars Property

Gets the Char object at a specified position in the current String object.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
'Declaration
Public ReadOnly Property Chars ( _
	index As Integer _
) As Char

Parameters

index
Type: System.Int32

A position in the current string.

Property Value

Type: System.Char
The object 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. 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.

Dim str1 As String = "Test" 
For ctr As Integer = 0 to str1.Length - 1
   Console.Write("{0} ", str1(ctr))
Next    
' The example displays the following output: 
'      T e s t         

The following example demonstrates how you can use this indexer in a routine to validate a string.

Console.Write("Type a string : ")
Dim myString As String = Console.ReadLine()
Dim i As Integer 
For i = 0 To myString.Length - 1
   If Uri.IsHexDigit(myString.Chars(i)) Then
      Console.WriteLine("{0} is a hexadecimal digit.", myString.Chars(i))
   Else
      Console.WriteLine("{0} is not a hexadecimal digit.", myString.Chars(i))
   End If  
Next 
' 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.         

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.