String.ToCharArray String.ToCharArray String.ToCharArray String.ToCharArray Method

Definizione

Copia i caratteri di questa istanza in una matrice di caratteri Unicode.Copies the characters in this instance to a Unicode character array.

Overload

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

Copia i caratteri di una determinata sottostringa di questa istanza in una matrice di caratteri Unicode.Copies the characters in a specified substring in this instance to a Unicode character array.

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

Copia i caratteri di questa istanza in una matrice di caratteri Unicode.Copies the characters in this instance to a Unicode character array.

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

Copia i caratteri di una determinata sottostringa di questa istanza in una matrice di caratteri Unicode.Copies the characters in a specified substring in this instance to a Unicode character array.

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

Posizione iniziale di una sottostringa in questa istanza.The starting position of a substring in this instance.

length
Int32 Int32 Int32 Int32

Lunghezza della sottostringa in questa istanza.The length of the substring in this instance.

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.A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

Eccezioni

startIndex o length è minore di zero.startIndex or length is less than zero.

-oppure--or- La somma di startIndex e length è maggiore della lunghezza di questa istanza.startIndex plus length is greater than the length of this instance.

Esempi

Nell'esempio seguente una sottostringa all'interno di una stringa viene convertita in una matrice di caratteri, quindi vengono enumerati e visualizzati gli elementi della matrice.The following example converts a substring within a string to an array of characters, then enumerates and displays the elements of the array.

// 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)
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 di una parte di una stringa in una matrice di caratteri.This method copies the characters in a portion of a string to a character array. Per creare una stringa da un intervallo di caratteri in una matrice di caratteri, chiamare String(Char[], Int32, Int32) il costruttore.To create a string from a range of characters in a character array, call the String(Char[], Int32, Int32) constructor.

Il startIndex parametro è in base zero.The startIndex parameter is zero-based. Ovvero l'indice del primo carattere nell'istanza di stringa è zero.That is, the index of the first character in the string instance is zero.

Se length è zero, la matrice restituita è vuota e ha una lunghezza pari a zero.If length is zero, the returned array is empty and has a zero length. Se questa istanza è null o una stringa vuota (""), la matrice restituita è vuota e ha una lunghezza pari a zero.If this instance is null or an empty string (""), the returned array is empty and has a zero length.

Per creare una matrice di byte che contiene i caratteri codificati in una parte di una stringa, creare un'istanza dell' Encoding oggetto appropriato e GetBytes(String, Int32, Int32, Byte[], Int32) chiamarne il metodo.To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate Encoding object and call its GetBytes(String, Int32, Int32, Byte[], Int32) method. Di seguito sono riportate alcune delle codifiche standard disponibili in .NET:Some of the standard encodings available in .NET include:

CodificaEncoding ObjectObject
nonASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Per altre informazioni, vedere codifica dei caratteri in .NET.For more information, see Character Encoding in .NET.

Vedi anche

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

Copia i caratteri di questa istanza in una matrice di caratteri Unicode.Copies the characters in this instance to a Unicode character array.

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.A Unicode character array whose elements are the individual characters of this instance. Se l'istanza è una stringa vuota, la matrice restituita sarà vuota e di lunghezza zero.If this instance is an empty string, the returned array is empty and has a zero length.

Esempi

Nell'esempio seguente viene chiamato ToCharArray il metodo per estrarre i caratteri di una stringa in una matrice di caratteri.The following example calls the ToCharArray method to extract the characters in a string to a character array. Viene quindi visualizzata la stringa originale e gli elementi nella matrice.It then displays the original string and the elements in the array.

using System;

public class Example
{
   public static void Main()
   {
      String s = "AaBbCcDd";
      var 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
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

Nell'esempio seguente viene definita una stringa contenente i caratteri utilizzati come delimitatori in una stringa delimitata.The following example defines a string containing the characters that serve as delimiters in a delimited string. Viene quindi chiamato il ToCharArray metodo per creare una matrice di caratteri che può essere passata Split(Char[]) al metodo per separare la stringa delimitata nelle singole sottostringhe.It then calls the ToCharArray method to create a character array that can be passed to the Split(Char[]) method to separate the delimited string into its individual substrings.

using namespace System;
using namespace System::Collections;
int main()
{
   String^ delimStr = " ,.:";
   array<Char>^delimiter = delimStr->ToCharArray();
   String^ words = "one two,three:four.";
   array<String^>^split = nullptr;
   Console::WriteLine( "The delimiters are -{0}-", delimStr );
   for ( int x = 1; x <= 5; x++ )
   {
      split = words->Split( delimiter, x );
      Console::WriteLine( "\ncount = {0, 2} ..............", x );
      IEnumerator^ myEnum = split->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ s = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "-{0}-", s );
      }

   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
using System;

public class Example
{
   public static void Main() 
   {
      string delimStr = " ,.:";
      char [] delimiter = delimStr.ToCharArray();
      string words = "one two,three:four.";
      string [] split = null;

      Console.WriteLine("The delimiters are -{0}-", delimStr);
      for (int x = 1; x <= 5; x++) {
         split = words.Split(delimiter, x);
         Console.WriteLine("\ncount = {0,2} ..............", x);
         foreach (var s in split) {
             Console.WriteLine("-{0}-", s);
         }
      }
   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
Public Class StringSplit2
   Public Shared Sub Main()
      
      Dim delimStr As String = " ,.:"
      Dim delimiter As Char() = delimStr.ToCharArray()
      Dim words As String = "one two,three:four."
      Dim split As String() = Nothing
      
      Console.WriteLine("The delimiters are -{0}-", delimStr)
      Dim x As Integer
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............", x)
         Dim s As String
         For Each s In  split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub 
End Class 
' The example displays the following output:
'       The delimiters are - ,.:-
'       count =  1 ..............
'       -one two,three:four.-
'       count =  2 ..............
'       -one-
'       -two,three:four.-
'       count =  3 ..............
'       -one-
'       -two-
'       -three:four.-
'       count =  4 ..............
'       -one-
'       -two-
'       -three-
'       -four.-
'       count =  5 ..............
'       -one-
'       -two-
'       -three-
'       -four-
'       --

Commenti

Questo metodo copia ogni carattere (ovvero ogni Char oggetto) in una stringa in una matrice di caratteri.This method copies each character (that is, each Char object) in a string to a character array. Il primo carattere copiato si trova in corrispondenza dell'indice zero della matrice di caratteri restituita; l'ultimo carattere copiato si trova in Array.Length corrispondenza dell'indice 1.The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length - 1.

Per creare una stringa dai caratteri in una matrice di caratteri, chiamare il String(Char[]) costruttore.To create a string from the characters in a character array, call the String(Char[]) constructor.

Per creare una matrice di byte che contiene i caratteri codificati in una stringa, creare un'istanza dell' Encoding oggetto appropriato e Encoding.GetBytes(String) chiamarne il metodo.To create a byte array that contains the encoded characters in a string, instantiate the appropriate Encoding object and call its Encoding.GetBytes(String) method. Di seguito sono riportate alcune delle codifiche standard disponibili in .NET:Some of the standard encodings available in .NET include the following:

CodificaEncoding ObjectObject
nonASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Per altre informazioni, vedere codifica dei caratteri in .NET.For more information, see Character Encoding in .NET.

Vedi anche

Si applica a