String.ToCharArray Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

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)

Copia i caratteri di una determinata sottostringa di 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.

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

ArgumentOutOfRangeException

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 namespace System;
using namespace System::Collections;
int main()
{
   String^ str = "012wxyz789";
   array<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 );
   IEnumerator^ myEnum = arr->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c =  safe_cast<Char>(myEnum->Current);
      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)
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 è 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

• Array
• Char
• Int32

ToCharArray()

Copia i caratteri di 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()

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

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 è 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

• Char
• Array