String.ToCharArray Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Az ebben a példányban lévő karaktereket Unicode-karaktertömbbe másolja.

Túlterhelések

Name	Description
ToCharArray(Int32, Int32)	Az ebben a példányban megadott alsztringben szereplő karaktereket Unicode-karaktertömbbe másolja.
ToCharArray()	Az ebben a példányban lévő karaktereket Unicode-karaktertömbbe másolja.

ToCharArray(Int32, Int32)

Forrás:

String.cs

Az ebben a példányban megadott alsztringben szereplő karaktereket Unicode-karaktertömbbe másolja.

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

Paraméterek

startIndex

Int32

Az alsztring kezdőpozíciója ebben a példányban.

length

Int32

Az alsztring hossza ebben a példányban.

Válaszok

Char[]

Unicode karaktertömb, amelynek elemei az ebben a length példányban szereplő karakterek száma karakterhelyzetből startIndexkiindulva.

Kivételek

ArgumentOutOfRangeException

startIndex vagy length kisebb, mint nulla.

-vagy-

startIndex plusz length nagyobb, mint a példány hossza.

Példák

Az alábbi példa egy sztringen belüli részstringet karaktertömbté alakítja, majd számba adja és megjeleníti a tömb elemeit.

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

Megjegyzések

Ez a metódus a sztring egy részének karaktereit egy karaktertömbbe másolja. Ha egy karaktertömb karaktertartományából szeretne sztringet létrehozni, hívja meg a konstruktort String(Char[], Int32, Int32) .

A startIndex paraméter nulla alapú. Ez azt jelenti, hogy a sztringpéldány első karakterének indexe nulla.

Ha length nulla, a visszaadott tömb üres, és nulla hosszúságú. Ha ez a null példány vagy egy üres sztring (""), a visszaadott tömb üres, és nulla hosszúságú.

Ha egy karakterlánc egy részének kódolt karaktereit tartalmazó bájttömböt szeretne létrehozni, példányosíthatja a megfelelő Encoding objektumot, és meghívhatja annak metódusát GetBytes(String, Int32, Int32, Byte[], Int32) . A .NET elérhető standard kódolások közül néhány a következők:

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

További információ: Karakterkódolás a .NET-ben.

Lásd még

• Array
• Char
• Int32

ToCharArray()

Forrás:

String.cs

Az ebben a példányban lévő karaktereket Unicode-karaktertömbbe másolja.

public:
 cli::array <char> ^ ToCharArray();

public char[] ToCharArray();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Válaszok

Char[]

Unicode-karaktertömb, amelynek elemei a példány egyedi karakterei. Ha ez a példány egy üres sztring, a visszaadott tömb üres, és nulla hosszúságú.

Példák

Az alábbi példa meghívja azt a ToCharArray metódust, amely egy sztringben lévő karaktereket egy karaktertömbbe bontja ki. Ezután megjeleníti az eredeti sztringet és a tömb elemeit.

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

Megjegyzések

Ez a metódus egy karakterlánc minden karakterét (vagyis minden Char objektumát) egy karaktertömbbe másolja. Az első másolt karakter a visszaadott karaktertömb index nulláján van; az utolsó másolt karakter az indexben Array.Length van – 1.

Ha sztringet szeretne létrehozni egy karaktertömb karaktereiből, hívja meg a konstruktort String(Char[]) .

Ha egy karakterlánc kódolt karaktereit tartalmazó bájttömböt szeretne létrehozni, példányosíthatja a megfelelő Encoding objektumot, és meghívhatja annak metódusát Encoding.GetBytes(String) . A .NET elérhető standard kódolások közül néhány a következőket tartalmazza:

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

További információ: Karakterkódolás a .NET-ben.

Lásd még

• Char
• Array