String.Chars[Int32] Propriété

Définition

Obtient l'objet Char à une position de caractère spécifiée dans l'objet String actuel.Gets the Char object at a specified position in the current String object.

public:
 property char default[int] { char get(int index); };
public char this[int index] { get; }
member this.Chars(int) : char
Default Public ReadOnly Property Chars(index As Integer) As Char

Paramètres

index
Int32

Position dans la chaîne actuelle.A position in the current string.

Valeur de propriété

Objet à la position index.The object at position index.

Exceptions

index est supérieur ou égal à la longueur de cet objet ou inférieur à zéro.index is greater than or equal to the length of this object or less than zero.

Exemples

L’exemple suivant montre comment vous pouvez utiliser cet indexeur dans une routine pour valider une chaîne.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.      
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.            
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.         

Remarques

Le paramètre index est de base zéro.The index parameter is zero-based.

Cette propriété retourne l’objet Char à la position spécifiée par le paramètre index.This property returns the Char object at the position specified by the index parameter. Toutefois, un caractère Unicode peut être représenté par plusieurs Char.However, a Unicode character might be represented by more than one Char. Utilisez la classe System.Globalization.StringInfo pour travailler avec des caractères Unicode au lieu de Char objets.Use the System.Globalization.StringInfo class to work with Unicode characters instead of Char objects. Pour plus d’informations, consultez la section « objets Char et caractères Unicode » dans la vue d’ensemble de la classe String.For more information, see the "Char Objects and Unicode Characters" section in the String class overview.

Dans C#, la propriété Chars[Int32] est un indexeur.In C#, the Chars[Int32] property is an indexer. Dans Visual Basic, il s’agit de la propriété par défaut de la classe String.In Visual Basic, it is the default property of the String class. Chaque objet Char de la chaîne est accessible à l’aide d’un code tel que le suivant.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++ )
   Console.Write("{0} ", str1[ctr]);
// The example displays the following output:
//      T e s t         
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         

S’applique à

Voir aussi