String.ToCharArray 方法

定義

將此處的字元複製到 Unicode 字元陣列。

多載

名稱 Description
ToCharArray(Int32, Int32)

在此實例中,將指定子串中的字元複製到 Unicode 字元陣列。

ToCharArray()

將此處的字元複製到 Unicode 字元陣列。

ToCharArray(Int32, Int32)

來源:
String.cs
來源:
String.cs
來源:
String.cs
來源:
String.cs
來源:
String.cs

在此實例中,將指定子串中的字元複製到 Unicode 字元陣列。

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()

參數

startIndex
Int32

此處為子字串的起始位置。

length
Int32

此處為子字串的長度。

傳回

Char[]

一個 Unicode 字元陣列,其元素是 length 從字元位置 startIndex開始的字元數。

例外狀況

startIndexlength 小於零。

-或-

startIndex plus 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
*/
// 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
'

備註

此方法將字串中的一部分字元複製到字元陣列。 要從字元陣列中的字元範圍建立字串,呼叫建構子。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 中的字元編碼。

另請參閱

適用於

ToCharArray()

來源:
String.cs
來源:
String.cs
來源:
String.cs
來源:
String.cs
來源:
String.cs

將此處的字元複製到 Unicode 字元陣列。

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

傳回

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

備註

此方法將字串中的每個字元(即每個 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 中的字元編碼。

另請參閱

適用於