String.Chars[Range] String.Chars[Range] String.Chars[Range] String.Chars[Range] Property

Definição

Sobrecargas

Chars[Index] Chars[Index] Chars[Index] Chars[Index]
Chars[Int32] Chars[Int32] Chars[Int32] Chars[Int32]

Obtém o objeto Char em uma posição especificada no atual objeto String.Gets the Char object at a specified position in the current String object.

Chars[Range] Chars[Range] Chars[Range] Chars[Range]

Chars[Index] Chars[Index] Chars[Index] Chars[Index]

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

Parâmetros

Valor da propriedade

Chars[Int32] Chars[Int32] Chars[Int32] Chars[Int32]

Obtém o objeto Char em uma posição especificada no atual objeto String.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

Parâmetros

index
Int32 Int32 Int32 Int32

Uma posição na cadeia de caracteres atual.A position in the current string.

Valor da propriedade

O objeto na posição index.The object at position index.

Exceções

index é maior ou igual ao tamanho desse objeto ou menor que zero.index is greater than or equal to the length of this object or less than zero.

Exemplos

O exemplo a seguir demonstra como você pode usar esse indexador em uma rotina para validar uma cadeia de caracteres.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.         

Comentários

O index parâmetro é baseado em zero.The index parameter is zero-based.

Essa propriedade retorna o Char objeto na posição especificada pelo index parâmetro.This property returns the Char object at the position specified by the index parameter. No entanto, um caractere Unicode pode ser representado por mais de um Char.However, a Unicode character might be represented by more than one Char. Use o System.Globalization.StringInfo caracteres de classe para trabalhar com o Unicode em vez de Char objetos.Use the System.Globalization.StringInfo class to work with Unicode characters instead of Char objects. Para obter mais informações, consulte a seção "Char caracteres objetos e Unicode" o String visão geral da classe.For more information, see the "Char Objects and Unicode Characters" section in the String class overview.

No c#, o Chars[Range] propriedade é um indexador.In C#, the Chars[Range] property is an indexer. No Visual Basic, é a propriedade padrão do String classe.In Visual Basic, it is the default property of the String class. Cada Char objeto na cadeia de caracteres pode ser acessado por meio de código como o seguinte.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         
Veja também

Chars[Range] Chars[Range] Chars[Range] Chars[Range]

public:
 property System::String ^ default[Range] { System::String ^ get(Range range); };
public string this[Range range] { get; }
member this.Chars(Range) : string
Default Public ReadOnly Property Chars(range As Range) As String

Parâmetros

Valor da propriedade

Aplica-se a