String.ToCharArray Metodo

Definizione

Copia i caratteri in questa istanza in una matrice di caratteri Unicode.

Overload

Nome Descrizione
ToCharArray(Int32, Int32)

Copia i caratteri in una sottostringa specificata in questa istanza in una matrice di caratteri Unicode.

ToCharArray()

Copia i caratteri in questa istanza in una matrice di caratteri Unicode.

ToCharArray(Int32, Int32)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Copia i caratteri in una sottostringa specificata in questa istanza in una matrice di caratteri 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()

Parametri

startIndex
Int32

Posizione iniziale di una sottostringa in questa istanza.

length
Int32

Lunghezza della sottostringa in questa istanza.

Valori restituiti

Char[]

Matrice di caratteri Unicode i cui elementi sono il length numero di caratteri in questa istanza a partire dalla posizione startIndexdel carattere .

Eccezioni

startIndex o length è minore di zero.

oppure

startIndex plus length è maggiore della lunghezza di questa istanza.

Esempio

L'esempio seguente converte una sottostringa all'interno di una stringa in una matrice di caratteri, quindi enumera e visualizza gli elementi della matrice.

// 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
'

Commenti

Questo metodo copia i caratteri in una parte di una stringa in una matrice di caratteri. Per creare una stringa da un intervallo di caratteri in una matrice di caratteri, chiamare il String(Char[], Int32, Int32) costruttore.

Il startIndex parametro è in base zero. Ovvero, l'indice del primo carattere nell'istanza della stringa è zero.

Se length è zero, la matrice restituita è vuota e ha una lunghezza zero. Se questa istanza è null o una stringa vuota (""), la matrice restituita è vuota e ha una lunghezza zero.

Per creare una matrice di byte contenente i caratteri codificati in una parte di una stringa, creare un'istanza dell'oggetto appropriato Encoding e chiamarne GetBytes(String, Int32, Int32, Byte[], Int32) il metodo. Alcune delle codifiche standard disponibili in .NET includono:

Codifica Oggetto
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Per altre informazioni, vedere Codifica dei caratteri in .NET.

Vedi anche

Si applica a

ToCharArray()

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Copia i caratteri in questa istanza in una matrice di caratteri Unicode.

public:
 cli::array <char> ^ ToCharArray();
public char[] ToCharArray();
member this.ToCharArray : unit -> char[]
Public Function ToCharArray () As Char()

Valori restituiti

Char[]

Matrice di caratteri Unicode i cui elementi sono i singoli caratteri di questa istanza. Se questa istanza è una stringa vuota, la matrice restituita è vuota e ha una lunghezza zero.

Esempio

Nell'esempio seguente viene chiamato il ToCharArray metodo per estrarre i caratteri in una stringa a una matrice di caratteri. Visualizza quindi la stringa originale e gli elementi nella matrice.

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

Commenti

Questo metodo copia ogni carattere , ovvero ogni Char oggetto, in una stringa in una matrice di caratteri. Il primo carattere copiato è in corrispondenza dell'indice zero della matrice di caratteri restituita; l'ultimo carattere copiato è in corrispondenza dell'indice Array.Length - 1.

Per creare una stringa dai caratteri in una matrice di caratteri, chiamare il String(Char[]) costruttore .

Per creare una matrice di byte contenente i caratteri codificati in una stringa, creare un'istanza dell'oggetto appropriato Encoding e chiamare il Encoding.GetBytes(String) relativo metodo. Alcune delle codifiche standard disponibili in .NET includono:

Codifica Oggetto
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Per altre informazioni, vedere Codifica dei caratteri in .NET.

Vedi anche

Si applica a