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

Definition

Kopiert die Zeichen dieser Instanz in ein Array von Unicode-Zeichen.Copies the characters in this instance to a Unicode character array.

Überlädt

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

Kopiert die Zeichen einer angegebenen Teilzeichenfolge dieser Instanz in ein Array von Unicode-Zeichen.Copies the characters in a specified substring in this instance to a Unicode character array.

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

Kopiert die Zeichen dieser Instanz in ein Array von Unicode-Zeichen.Copies the characters in this instance to a Unicode character array.

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

Kopiert die Zeichen einer angegebenen Teilzeichenfolge dieser Instanz in ein Array von Unicode-Zeichen.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()

Parameter

startIndex
Int32 Int32 Int32 Int32

Die Anfangsposition einer Teilzeichenfolge innerhalb dieser Instanz.The starting position of a substring in this instance.

length
Int32 Int32 Int32 Int32

Die Länge einer Teilzeichenfolge innerhalb dieser Instanz.The length of the substring in this instance.

Gibt zurück

Char[]

Ein Array von Unicode-Zeichen, dessen Elemente die length-Zeichen dieser Instanz ab Zeichenposition startIndex sind.A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

Ausnahmen

startIndex oder length ist kleiner als 0.startIndex or length is less than zero.

- oder --or- startIndex plus length ist größer als die Länge dieser Instanz.startIndex plus length is greater than the length of this instance.

Beispiele

Im folgenden Beispiel wird eine Teil Zeichenfolge innerhalb einer Zeichenfolge in ein Zeichen Array konvertiert. Anschließend werden die Elemente des Arrays aufgelistet und angezeigt.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 'Sample
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

Hinweise

Diese Methode kopiert die Zeichen in einem Teil einer Zeichenfolge in ein Zeichen Array.This method copies the characters in a portion of a string to a character array. Um eine Zeichenfolge aus einem Zeichenbereich in einem Zeichen Array zu erstellen, rufen String(Char[], Int32, Int32) Sie den-Konstruktor auf.To create a string from a range of characters in a character array, call the String(Char[], Int32, Int32) constructor.

Der startIndex -Parameter ist NULL basiert.The startIndex parameter is zero-based. Das heißt, der Index des ersten Zeichens in der Zeichen folgen Instanz ist 0 (null).That is, the index of the first character in the string instance is zero.

Wenn length 0 (null) ist, ist das zurückgegebene Array leer und hat die Länge 0 (null).If length is zero, the returned array is empty and has a zero length. Wenn diese Instanz oder null eine leere Zeichenfolge ("") ist, ist das zurückgegebene Array leer und hat eine Länge von 0 (null).If this instance is null or an empty string (""), the returned array is empty and has a zero length.

Um ein Bytearray zu erstellen, das die codierten Zeichen in einem Teil einer Zeichenfolge enthält, instanziieren Sie das GetBytes(String, Int32, Int32, Byte[], Int32) entsprechende Encoding -Objekt, und rufen Sie dessen-Methode auf.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. Zu den in .NET verfügbaren Standard Codierungen gehören:Some of the standard encodings available in .NET include:

CodierungEncoding ObjectObject
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Weitere Informationen finden Sie unter Zeichencodierung in .net.For more information, see Character Encoding in .NET.

Siehe auch

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

Kopiert die Zeichen dieser Instanz in ein Array von Unicode-Zeichen.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()

Gibt zurück

Char[]

Ein Array von Unicode-Zeichen, dessen Elemente die einzelnen Zeichen dieser Instanz darstellen.A Unicode character array whose elements are the individual characters of this instance. Wenn diese Instanz eine leere Zeichenfolge ist, ist das zurückgegebene Array leer und hat die Länge 0.If this instance is an empty string, the returned array is empty and has a zero length.

Beispiele

Im folgenden Beispiel wird die ToCharArray -Methode aufgerufen, um die Zeichen in einer Zeichenfolge in ein Zeichen Array zu extrahieren.The following example calls the ToCharArray method to extract the characters in a string to a character array. Anschließend werden die Original Zeichenfolge und die Elemente im Array angezeigt.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

Im folgenden Beispiel wird eine Zeichenfolge definiert, die die Zeichen enthält, die in einer durch Trennzeichen getrennten Zeichenfolge als Trennzeichen fungieren.The following example defines a string containing the characters that serve as delimiters in a delimited string. Anschließend wird die ToCharArray -Methode aufgerufen, um ein Zeichen Array zu erstellen, das an Split(Char[]) die-Methode weitergegeben werden kann, um die Zeichenfolge in die einzelnen Teil Zeichenfolgen zu trennen.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-
'       --

Hinweise

Diese Methode kopiert jedes Zeichen (d. h. Char jedes Objekt) in einer Zeichenfolge in ein Zeichen Array.This method copies each character (that is, each Char object) in a string to a character array. Das erste kopierte Zeichen weist den Index NULL des zurückgegebenen Zeichen Arrays auf. das letzte kopierte Zeichen befindet sich Array.Length am Index-1.The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length - 1.

Um eine Zeichenfolge aus den Zeichen in einem Zeichen Array zu erstellen, String(Char[]) rufen Sie den-Konstruktor auf.To create a string from the characters in a character array, call the String(Char[]) constructor.

Zum Erstellen eines Bytearrays, das die codierten Zeichen in einer Zeichenfolge enthält, instanziieren Sie das Encoding.GetBytes(String) entsprechende Encoding -Objekt, und rufen Sie dessen-Methode aufTo create a byte array that contains the encoded characters in a string, instantiate the appropriate Encoding object and call its Encoding.GetBytes(String) method. Einige der in .NET verfügbaren Standard Codierungen umfassen Folgendes:Some of the standard encodings available in .NET include the following:

CodierungEncoding ObjectObject
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Weitere Informationen finden Sie unter Zeichencodierung in .net.For more information, see Character Encoding in .NET.

Siehe auch

Gilt für: