String.ToCharArray Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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
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.