String.ToCharArray Metoda

Definicja

Kopiuje znaki w tym wystąpieniu do tablicy znaków Unicode.

Przeciążenia

ToCharArray(Int32, Int32)

Kopiuje znaki w określonym podciągu w tym wystąpieniu do tablicy znaków Unicode.

ToCharArray()

Kopiuje znaki w tym wystąpieniu do tablicy znaków Unicode.

ToCharArray(Int32, Int32)

Źródło:
String.cs
Źródło:
String.cs
Źródło:
String.cs

Kopiuje znaki w określonym podciągu w tym wystąpieniu do tablicy znaków Unicode.

C#
public char[] ToCharArray(int startIndex, int length);

Parametry

startIndex
Int32

Pozycja początkowa podciągów w tym wystąpieniu.

length
Int32

Długość podciągów w tym wystąpieniu.

Zwraca

Char[]

Tablica znaków Unicode, której elementy są length liczbą znaków w tym wystąpieniu, począwszy od pozycji startIndexznaku .

Wyjątki

startIndex wartość lub length jest mniejsza niż zero.

-lub-

startIndex znak plus length jest większy niż długość tego wystąpienia.

Przykłady

Poniższy przykład konwertuje podciąg w ciągu na tablicę znaków, a następnie wylicza i wyświetla elementy tablicy.

C#
// 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
*/

Uwagi

Ta metoda kopiuje znaki w części ciągu do tablicy znaków. Aby utworzyć ciąg na podstawie zakresu znaków w tablicy znaków, wywołaj String(Char[], Int32, Int32) konstruktor.

Parametr startIndex jest oparty na zerze. Oznacza to, że indeks pierwszego znaku w wystąpieniu ciągu ma wartość zero.

Jeśli length jest równa zero, zwracana tablica jest pusta i ma zero długości. Jeśli to wystąpienie jest null lub ciąg pusty (""), zwracana tablica jest pusta i ma zero długości.

Aby utworzyć tablicę bajtów zawierającą zakodowane znaki w części ciągu, utwórz wystąpienie odpowiedniego Encoding obiektu i wywołaj jego GetBytes(String, Int32, Int32, Byte[], Int32) metodę. Oto niektóre standardowe kodowania dostępne na platformie .NET:

Encoding Obiekt
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET.

Zobacz też

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToCharArray()

Źródło:
String.cs
Źródło:
String.cs
Źródło:
String.cs

Kopiuje znaki w tym wystąpieniu do tablicy znaków Unicode.

C#
public char[] ToCharArray();

Zwraca

Char[]

Tablica znaków Unicode, której elementy są poszczególnymi znakami tego wystąpienia. Jeśli to wystąpienie jest pustym ciągiem, zwracana tablica jest pusta i ma zero długości.

Przykłady

Poniższy przykład wywołuje metodę ToCharArray , aby wyodrębnić znaki w ciągu do tablicy znaków. Następnie wyświetla oryginalny ciąg i elementy w tablicy.

C#
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

Uwagi

Ta metoda kopiuje każdy znak (czyli każdy Char obiekt) w ciągu do tablicy znaków. Pierwszy skopiowany znak znajduje się w indeksie zero zwracanej tablicy znaków; ostatni skopiowany znak znajduje się w indeksie Array.Length — 1.

Aby utworzyć ciąg na podstawie znaków w tablicy znaków, wywołaj String(Char[]) konstruktor.

Aby utworzyć tablicę bajtów zawierającą zakodowane znaki w ciągu, utwórz wystąpienie odpowiedniego Encoding obiektu i wywołaj jego Encoding.GetBytes(String) metodę. Niektóre standardowe kodowania dostępne na platformie .NET obejmują następujące elementy:

Encoding Obiekt
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET.

Zobacz też

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0