String.ToCharArray Método

Definição

Espaço de Nomes:

System

Assemblagens:

netstandard.dll, System.Runtime.dll

Copia os caracteres neste caso para um array de caracteres Unicode.

Sobrecargas

Name	Description
ToCharArray(Int32, Int32)	Copia os caracteres de uma substring especificada neste caso para um array de caracteres Unicode.
ToCharArray()	Copia os caracteres neste caso para um array de caracteres Unicode.

ToCharArray(Int32, Int32)

Origem:

String.cs

Copia os caracteres de uma substring especificada neste caso para um array de caracteres Unicode.

public:
 cli::array <char> ^ ToCharArray(int startIndex, int length);

public char[] ToCharArray(int startIndex, int length);

member this.ToCharArray : int * int -> char[]

Public Function ToCharArray (startIndex As Integer, length As Integer) As Char()

Parâmetros

startIndex

Int32

A posição inicial de uma subcorda neste caso.

length

Int32

O comprimento da subcorda neste caso.

Devoluções

Char[]

Um array de caracteres Unicode cujos elementos são o length número de caracteres neste caso a partir da posição startIndexde caracteres .

Exceções

ArgumentOutOfRangeException

startIndex ou length é inferior a zero.

-ou-

startIndex mais length é maior do que o comprimento desta instância.

Exemplos

O exemplo seguinte converte uma substring dentro de uma string num array de caracteres, depois enumera e apresenta os elementos do array.

// Sample for String.ToCharArray(Int32, Int32)
using System;

class Sample {
    public static void Main() {
    string str = "012wxyz789";
    char[] arr;

    arr = str.ToCharArray(3, 4);
    Console.Write("The letters in '{0}' are: '", str);
    Console.Write(arr);
    Console.WriteLine("'");
    Console.WriteLine("Each letter in '{0}' is:", str);
    foreach (char c in arr)
        Console.WriteLine(c);
    }
}
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

// Sample for String.ToCharArray(Int32, Int32)
let str = "012wxyz789"

let arr = str.ToCharArray(3, 4)
printf $"The letters in '{str}' are: '"
printf $"{arr}"
printfn "'"
printfn $"Each letter in '{str}' is:"
for c in arr do
    printfn $"{c}"
(*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*)

' Sample for String.ToCharArray(Int32, Int32)
Class Sample
   
   Public Shared Sub Main()
      Dim str As String = "012wxyz789"
      Dim arr() As Char
      
      arr = str.ToCharArray(3, 4)
      Console.Write("The letters in '{0}' are: '", str)
      Console.Write(arr)
      Console.WriteLine("'")
      Console.WriteLine("Each letter in '{0}' is:", str)
      Dim c As Char
      For Each c In arr
         Console.WriteLine(c)
      Next c
   End Sub
End Class
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

Observações

Este método copia os caracteres de uma parte de uma cadeia para um array de caracteres. Para criar uma cadeia a partir de um conjunto de caracteres num array de caracteres, chame o String(Char[], Int32, Int32) construtor.

O startIndex parâmetro é baseado em zero. Ou seja, o índice do primeiro carácter na instância da cadeia é zero.

Se length for zero, o array devolvido é vazio e tem comprimento zero. Se esta instância for null ou uma cadeia vazia (""), o array devolvido é vazio e tem comprimento zero.

Para criar um array de bytes que contenha os caracteres codificados numa porção de uma string, instancia o objeto apropriado Encoding e chama o seu GetBytes(String, Int32, Int32, Byte[], Int32) método. Algumas das codificações padrão disponíveis em .NET incluem:

Codificação	Objetivo
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Para obter mais informações, consulte Codificação de caracteres no .NET.

Ver também

• Array
• Char
• Int32

ToCharArray()

Origem:

String.cs

Copia os caracteres neste caso para um array de caracteres Unicode.

public:
 cli::array <char> ^ ToCharArray();

public char[] ToCharArray();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Devoluções

Char[]

Um array de caracteres Unicode cujos elementos são os caracteres individuais desta instância. Se esta instância for uma cadeia vazia, o array devolvido é vazio e tem comprimento zero.

Exemplos

O exemplo seguinte chama o ToCharArray método para extrair os caracteres de uma string para um array de caracteres. Depois, mostra a cadeia original e os elementos do arranjo.

using System;

public class Example
{
   public static void Main()
   {
      string s = "AaBbCcDd";
      char[] chars = s.ToCharArray();
      Console.WriteLine("Original string: {0}", s);
      Console.WriteLine("Character array:");
      for (int ctr = 0; ctr < chars.Length; ctr++)
      {
         Console.WriteLine("   {0}: {1}", ctr, chars[ctr]);
      }
   }
}

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d

let s = "AaBbCcDd"
let chars = s.ToCharArray()
printfn $"Original string: {s}"
printfn "Character array:"
for i = 0 to chars.Length - 1 do
    printfn $"   {i}: {chars[i]}"

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d

Module Example
   Public Sub Main()
      Dim s As String = "AaBbCcDd"
      Dim chars() = s.ToCharArray()
      Console.WriteLine("Original string: {0}", s)
      Console.WriteLine("Character array:")
      For ctr = 0 to chars.Length - 1
         Console.WriteLine("   {0}: {1}", ctr, chars(ctr))
      Next
   End Sub
End Module
' The example displays the following output:
'     Original string: AaBbCcDd
'     Character array:
'        0: A
'        1: a
'        2: B
'        3: b
'        4: C
'        5: c
'        6: D
'        7: d

Observações

Este método copia cada carácter (isto é, cada Char objeto) numa cadeia de caracteres para um array de caracteres. O primeiro carácter copiado está no índice zero do array de caracteres devolvido; O último carácter copiado está no índice Array.Length - 1.

Para criar uma cadeia de caracteres a partir dos caracteres de um array de caracteres, chama o String(Char[]) construtor.

Para criar um array de bytes que contenha os caracteres codificados numa cadeia, instancia o objeto apropriado Encoding e chama o seu Encoding.GetBytes(String) método. Algumas das codificações padrão disponíveis em .NET incluem as seguintes:

Codificação	Objetivo
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Para obter mais informações, consulte Codificação de caracteres no .NET.

Ver também

• Char
• Array