Leggere in inglese

Condividi tramite


String.ToCharArray Metodo

Definizione

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

Overload

ToCharArray(Int32, Int32)

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

ToCharArray()

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

ToCharArray(Int32, Int32)

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

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

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

Parametri

startIndex
Int32

Posizione iniziale di una sottostringa in questa istanza.

length
Int32

Lunghezza della sottostringa in questa istanza.

Restituisce

Char[]

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

Eccezioni

startIndex o length è minore di zero.

-oppure-

La somma di startIndex e 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
*/

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 è basato su zero. Vale a dire, l'indice del primo carattere nell'istanza di stringa è zero.

Se length è zero, la matrice restituita è vuota e ha una lunghezza zero. Se questa istanza è o una stringa vuota (""), la matrice restituita è null 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 chiamare GetBytes(String, Int32, Int32, Byte[], Int32) il relativo metodo. Alcune delle codifica 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

.NET 10 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToCharArray()

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

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

public char[] ToCharArray();

Restituisce

Char[]

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

Esempio

Nell'esempio seguente viene chiamato il ToCharArray metodo per estrarre i caratteri in una stringa in 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

Commenti

Questo metodo copia ogni carattere , ovvero ogni Char oggetto, in una stringa in una matrice di caratteri. Il primo carattere copiato è a zero indice 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 codifica standard disponibili in .NET includono quanto segue:

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

.NET 10 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0