String.ToCharArray 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

將這個執行個體中的字元複製到 Unicode 字元陣列中。

多載

ToCharArray(Int32, Int32)	將這個執行個體的指定子字串字元複製到 Unicode 字元陣列。
ToCharArray()	將這個執行個體中的字元複製到 Unicode 字元陣列中。

ToCharArray(Int32, Int32)

來源:

String.cs

將這個執行個體的指定子字串字元複製到 Unicode 字元陣列。

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

參數

startIndex

Int32

這個執行個體中的子字串開始位置。

length

Int32

這個執行個體中的子字串長度。

傳回

Char[]

Unicode 字元陣列，其項目是從 length 字元位置起始的這個執行個體中的 startIndex 字元數。

例外狀況

ArgumentOutOfRangeException

startIndex 或 length 小於零。

-或-

startIndex 加上 length 大於這個執行個體的長度。

範例

下列範例會將字串內的子字串轉換成字元陣列，然後列舉並顯示陣列的專案。

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

備註

這個方法會將字串中部分的字元複製到字元陣列。 若要從字元陣列中的字元範圍建立字串，請呼叫 建 String(Char[], Int32, Int32) 構函式。

參數 startIndex 是以零起始。 也就是說，字串實例中第一個字元的索引是零。

如果 length 為零，則傳回的陣列是空的，且長度為零。 如果這個實例是 null 或空字串 (「」) ，傳回的陣列是空的，而且長度為零。

若要建立包含字串部分編碼字元的位元組陣列，請具現化適當的 Encoding 物件並呼叫其 GetBytes(String, Int32, Int32, Byte[], Int32) 方法。 .NET 中提供的一些標準編碼包括：

編碼	物件
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

如需詳細資訊，請參閱 .NET 中的字元編碼。

另請參閱

• Array
• Char
• Int32

ToCharArray()

來源:

String.cs

將這個執行個體中的字元複製到 Unicode 字元陣列中。

public char[] ToCharArray();

傳回

Char[]

Unicode 字元陣列，其項目是這個執行個體的個別字元。 如果這個執行個體是空字串，則傳回的陣列會是空的且長度為零。

範例

下列範例會 ToCharArray 呼叫 方法，將字串中的字元擷取至字元陣列。 然後會顯示原始字串和陣列中的元素。

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

備註

這個方法會將字串中的每個字元 (複製到字元陣列中每個 Char 物件) 。 複製的第一個字元位於傳回字元陣列的索引零處;複製的最後一個字元位於索引 Array.Length - 1。

若要從字元陣列中的字元建立字串，請呼叫 建 String(Char[]) 構函式。

若要建立包含字串中編碼字元的位元組陣列，請具現化適當的 Encoding 物件並呼叫其 Encoding.GetBytes(String) 方法。 .NET 中提供的一些標準編碼包括下列各項：

編碼	物件
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

如需詳細資訊，請參閱 .NET 中的字元編碼。

另請參閱

• Char
• Array