String.ToCharArray Metodo
In questo articolo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Copia i caratteri di questa istanza in una matrice di caratteri Unicode.
Overload
ToCharArray(Int32, Int32) |
Copia i caratteri di una determinata sottostringa di questa istanza in una matrice di caratteri Unicode. |
ToCharArray() |
Copia i caratteri di questa istanza in una matrice di caratteri Unicode. |
- Origine:
- String.cs
- Origine:
- String.cs
- Origine:
- String.cs
- Origine:
- String.cs
Copia i caratteri di una determinata sottostringa di questa istanza in una matrice di caratteri 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()
Parametri
- startIndex
- Int32
Posizione iniziale di una sottostringa in questa istanza.
- length
- Int32
Lunghezza della sottostringa in questa istanza.
Restituisce
Matrice di caratteri Unicode i cui elementi sono il numero length
di caratteri di questa istanza a partire dalla posizione startIndex
del carattere.
Eccezioni
startIndex
o length
è minore di zero.
-oppure-
La somma di startIndex
e length
è maggiore della lunghezza di questa istanza.
Esempio
L'esempio seguente converte una sottostringa all'interno di una stringa in una matrice di caratteri, quindi enumera e visualizza gli elementi della matrice.
// Sample for String::ToCharArray(Int32, Int32)
using namespace System;
using namespace System::Collections;
int main()
{
String^ str = "012wxyz789";
array<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 );
IEnumerator^ myEnum = arr->GetEnumerator();
while ( myEnum->MoveNext() )
{
Char c = safe_cast<Char>(myEnum->Current);
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)
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
'
Commenti
Questo metodo copia i caratteri in una parte di una stringa in una matrice di caratteri. Per creare una stringa da un intervallo di caratteri in una matrice di caratteri, chiamare il String(Char[], Int32, Int32) costruttore.
Il startIndex
parametro è basato su zero. Vale a dire, l'indice del primo carattere nell'istanza di stringa è zero.
Se length
è zero, la matrice restituita è vuota e ha una lunghezza zero. Se questa istanza è o una stringa vuota (""), la matrice restituita è null
vuota e ha una lunghezza zero.
Per creare una matrice di byte contenente i caratteri codificati in una parte di una stringa, creare un'istanza dell'oggetto appropriato Encoding e chiamare GetBytes(String, Int32, Int32, Byte[], Int32) il relativo metodo. Alcune delle codifica standard disponibili in .NET includono:
Codifica | Oggetto |
---|---|
ASCII | ASCIIEncoding |
UTF-7 | UTF7Encoding |
UTF-8 | UTF8Encoding |
UTF-16 | UnicodeEncoding |
UTF-32 | UTF32Encoding |
Per altre informazioni, vedere Codifica dei caratteri in .NET.
Vedi anche
Si applica a
.NET 10 e altre versioni
Prodotto | Versioni |
---|---|
.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 |
- Origine:
- String.cs
- Origine:
- String.cs
- Origine:
- String.cs
- Origine:
- String.cs
Copia i caratteri di questa istanza in una matrice di caratteri Unicode.
public:
cli::array <char> ^ ToCharArray();
public char[] ToCharArray();
member this.ToCharArray : unit -> char[]
Public Function ToCharArray () As Char()
Restituisce
Matrice di caratteri Unicode i cui elementi sono i singoli caratteri di questa istanza. Se l'istanza è una stringa vuota, la matrice restituita sarà vuota e di lunghezza zero.
Esempio
Nell'esempio seguente viene chiamato il ToCharArray metodo per estrarre i caratteri in una stringa in una matrice di caratteri. Visualizza quindi la stringa originale e gli elementi nella matrice.
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
Commenti
Questo metodo copia ogni carattere , ovvero ogni Char oggetto, in una stringa in una matrice di caratteri. Il primo carattere copiato è a zero indice della matrice di caratteri restituita; l'ultimo carattere copiato è in corrispondenza dell'indice Array.Length - 1.
Per creare una stringa dai caratteri in una matrice di caratteri, chiamare il String(Char[]) costruttore.
Per creare una matrice di byte contenente i caratteri codificati in una stringa, creare un'istanza dell'oggetto appropriato Encoding e chiamare il Encoding.GetBytes(String) relativo metodo. Alcune delle codifica standard disponibili in .NET includono quanto segue:
Codifica | Oggetto |
---|---|
ASCII | ASCIIEncoding |
UTF-7 | UTF7Encoding |
UTF-8 | UTF8Encoding |
UTF-16 | UnicodeEncoding |
UTF-32 | UTF32Encoding |
Per altre informazioni, vedere Codifica dei caratteri in .NET.
Vedi anche
Si applica a
.NET 10 e altre versioni
Prodotto | Versioni |
---|---|
.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 |