String.ToCharArray Methode

Definition

Kopiert die Zeichen in dieser Instanz in ein Unicode-Zeichenarray.

Überlädt

Name Beschreibung
ToCharArray(Int32, Int32)

Kopiert die Zeichen in einer angegebenen Teilzeichenfolge in dieser Instanz in ein Unicode-Zeichenarray.

ToCharArray()

Kopiert die Zeichen in dieser Instanz in ein Unicode-Zeichenarray.

ToCharArray(Int32, Int32)

Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs

Kopiert die Zeichen in einer angegebenen Teilzeichenfolge in dieser Instanz in ein Unicode-Zeichenarray.

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

Die Anfangsposition einer Teilzeichenfolge in dieser Instanz.

length
Int32

Die Länge der Teilzeichenfolge in dieser Instanz.

Gibt zurück

Char[]

Ein Unicode-Zeichenarray, dessen Elemente die length Anzahl der Zeichen in dieser Instanz ab Zeichenposition startIndexsind.

Ausnahmen

startIndex oder length ist kleiner als Null.

-oder-

startIndex Plus length ist größer als die Länge dieser Instanz.

Beispiele

Im folgenden Beispiel wird eine Teilzeichenfolge innerhalb einer Zeichenfolge in ein Array von Zeichen konvertiert. Anschließend werden die Elemente des Arrays aufgezählt und angezeigt.

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

Hinweise

Diese Methode kopiert die Zeichen in einem Teil einer Zeichenfolge in ein Zeichenarray. Rufen Sie den String(Char[], Int32, Int32) Konstruktor auf, um eine Zeichenfolge aus einem Zeichenbereich in einem Zeichenarray zu erstellen.

Der startIndex Parameter ist nullbasiert. Das heißt, der Index des ersten Zeichens in der Zeichenfolgeninstanz ist Null.

Wenn length null ist, ist das zurückgegebene Array leer und hat eine Leere. Wenn diese Instanz oder eine leere Zeichenfolge ("") ist null , ist das zurückgegebene Array leer und hat eine Länge null.

Um ein Bytearray zu erstellen, das die codierten Zeichen in einem Teil einer Zeichenfolge enthält, instanziieren Sie das entsprechende Encoding Objekt, und rufen Sie dessen GetBytes(String, Int32, Int32, Byte[], Int32) Methode auf. Einige der in .NET verfügbaren Standardcodierungen umfassen:

Codieren Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Weitere Informationen finden Sie unter Zeichencodierung in .NET.

Weitere Informationen

Gilt für:

ToCharArray()

Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs

Kopiert die Zeichen in dieser Instanz in ein Unicode-Zeichenarray.

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

Gibt zurück

Char[]

Ein Unicode-Zeichenarray, dessen Elemente die einzelnen Zeichen dieser Instanz sind. Wenn es sich bei dieser Instanz um eine leere Zeichenfolge handelt, ist das zurückgegebene Array leer und hat eine Länge null.

Beispiele

Im folgenden Beispiel wird die ToCharArray Methode aufgerufen, um die Zeichen in einer Zeichenfolge in ein Zeichenarray zu extrahieren. Anschließend werden die ursprüngliche Zeichenfolge und die Elemente im Array angezeigt.

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

Hinweise

Diese Methode kopiert jedes Zeichen (d. h. jedes Char Objekt) in einer Zeichenfolge in ein Zeichenarray. Das erste kopierte Zeichen befindet sich bei Index Null des zurückgegebenen Zeichenarrays; Das letzte kopierte Zeichen befindet sich im Index Array.Length - 1.

Rufen Sie den String(Char[]) Konstruktor auf, um eine Zeichenfolge aus den Zeichen in einem Zeichenarray zu erstellen.

Um ein Bytearray zu erstellen, das die codierten Zeichen in einer Zeichenfolge enthält, instanziieren Sie das entsprechende Encoding Objekt, und rufen Sie dessen Encoding.GetBytes(String) Methode auf. Einige der in .NET verfügbaren Standardcodierungen umfassen Folgendes:

Codieren Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Weitere Informationen finden Sie unter Zeichencodierung in .NET.

Weitere Informationen

Gilt für: