String.ToCharArray String.ToCharArray String.ToCharArray String.ToCharArray Method

Definición

Copia los caracteres de la instancia en una matriz de caracteres Unicode.Copies the characters in this instance to a Unicode character array.

Sobrecargas

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

Copia los caracteres de la instancia en una matriz de caracteres Unicode.Copies the characters in this instance to a Unicode character array.

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

Copia los caracteres de una subcadena especificada de la instancia en una matriz de caracteres Unicode.Copies the characters in a specified substring in this instance to a Unicode character array.

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

Copia los caracteres de la instancia en una matriz de caracteres Unicode.Copies the characters in this instance to a Unicode character array.

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

Devoluciones

Char[]

Matriz de caracteres Unicode cuyos elementos son los caracteres individuales de la instancia.A Unicode character array whose elements are the individual characters of this instance. Si la instancia es una cadena vacía, la matriz devuelta es una matriz vacía y su longitud es nula.If this instance is an empty string, the returned array is empty and has a zero length.

Ejemplos

El ejemplo siguiente se llama el ToCharArray método para extraer los caracteres de una cadena en una matriz de caracteres.The following example calls the ToCharArray method to extract the characters in a string to a character array. A continuación, se muestra la cadena original y los elementos de la matriz.It then displays the original string and the elements in the array.

using System;

public class Example
{
   public static void Main()
   {
      String s = "AaBbCcDd";
      var 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
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

El ejemplo siguiente define una cadena que contiene los caracteres que actúan como delimitadores en una cadena delimitada.The following example defines a string containing the characters that serve as delimiters in a delimited string. A continuación, llama el ToCharArray método para crear una matriz de caracteres que se puede pasar a la Split(Char[]) método para separar la cadena delimitada en sus subcadenas individuales.It then calls the ToCharArray method to create a character array that can be passed to the Split(Char[]) method to separate the delimited string into its individual substrings.

using namespace System;
using namespace System::Collections;
int main()
{
   String^ delimStr = " ,.:";
   array<Char>^delimiter = delimStr->ToCharArray();
   String^ words = "one two,three:four.";
   array<String^>^split = nullptr;
   Console::WriteLine( "The delimiters are -{0}-", delimStr );
   for ( int x = 1; x <= 5; x++ )
   {
      split = words->Split( delimiter, x );
      Console::WriteLine( "\ncount = {0, 2} ..............", x );
      IEnumerator^ myEnum = split->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ s = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "-{0}-", s );
      }

   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
using System;

public class Example
{
   public static void Main() 
   {
      string delimStr = " ,.:";
      char [] delimiter = delimStr.ToCharArray();
      string words = "one two,three:four.";
      string [] split = null;

      Console.WriteLine("The delimiters are -{0}-", delimStr);
      for (int x = 1; x <= 5; x++) {
         split = words.Split(delimiter, x);
         Console.WriteLine("\ncount = {0,2} ..............", x);
         foreach (var s in split) {
             Console.WriteLine("-{0}-", s);
         }
      }
   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
Public Class StringSplit2
   Public Shared Sub Main()
      
      Dim delimStr As String = " ,.:"
      Dim delimiter As Char() = delimStr.ToCharArray()
      Dim words As String = "one two,three:four."
      Dim split As String() = Nothing
      
      Console.WriteLine("The delimiters are -{0}-", delimStr)
      Dim x As Integer
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............", x)
         Dim s As String
         For Each s In  split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub 
End Class 
' The example displays the following output:
'       The delimiters are - ,.:-
'       count =  1 ..............
'       -one two,three:four.-
'       count =  2 ..............
'       -one-
'       -two,three:four.-
'       count =  3 ..............
'       -one-
'       -two-
'       -three:four.-
'       count =  4 ..............
'       -one-
'       -two-
'       -three-
'       -four.-
'       count =  5 ..............
'       -one-
'       -two-
'       -three-
'       -four-
'       --

Comentarios

Este método copia cada carácter (es decir, cada uno de ellos Char objeto) en una cadena a una matriz de caracteres.This method copies each character (that is, each Char object) in a string to a character array. Es el primer carácter que se copian en el índice cero de la matriz de caracteres devueltos; el último carácter copiado está en el índice Array.Length - 1.The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length - 1.

Para crear una cadena de los caracteres en una matriz de caracteres, llame a la String(Char[]) constructor.To create a string from the characters in a character array, call the String(Char[]) constructor.

Para crear una matriz de bytes que contiene los caracteres codificados en una cadena, cree una instancia adecuado Encoding objeto y llamar a su Encoding.GetBytes(String) método.To create a byte array that contains the encoded characters in a string, instantiate the appropriate Encoding object and call its Encoding.GetBytes(String) method. Algunas de las codificaciones estándares disponibles en .NET incluyen lo siguiente:Some of the standard encodings available in .NET include the following:

CodificaciónEncoding ObjectObject
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Para obtener más información, consulte codificación de caracteres en .NET.For more information, see Character Encoding in .NET.

Consulte también:

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

Copia los caracteres de una subcadena especificada de la instancia en una matriz de caracteres Unicode.Copies the characters in a specified substring in this instance to a Unicode character array.

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

Parámetros

startIndex
Int32 Int32 Int32 Int32

Posición inicial de una subcadena en la instancia.The starting position of a substring in this instance.

length
Int32 Int32 Int32 Int32

Longitud de la subcadena en la instancia.The length of the substring in this instance.

Devoluciones

Char[]

Matriz de caracteres Unicode cuyos elementos son el número de caracteres de la instancia especificado en length a partir de la posición de carácter startIndex.A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

Excepciones

startIndex o length es menor que cero.startIndex or length is less than zero.

O bien-or- startIndex más length es mayor que la longitud de esta instancia.startIndex plus length is greater than the length of this instance.

Ejemplos

El ejemplo siguiente convierte una subcadena dentro de una cadena en una matriz de caracteres, a continuación, enumera y muestra los elementos de la matriz.The following example converts a substring within a string to an array of characters, then enumerates and displays the elements of the array.

// 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)
Imports System

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 'Main
End Class 'Sample
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

Comentarios

Este método copia los caracteres en una parte de una cadena en una matriz de caracteres.This method copies the characters in a portion of a string to a character array. Para crear una cadena de un intervalo de caracteres en una matriz de caracteres, llame a la String(Char[], Int32, Int32) constructor.To create a string from a range of characters in a character array, call the String(Char[], Int32, Int32) constructor.

El startIndex parámetro está basado en cero.The startIndex parameter is zero-based. Es decir, el índice del primer carácter en la instancia de cadena es cero.That is, the index of the first character in the string instance is zero.

Si length es cero, la matriz devuelta está vacía y tiene una longitud cero.If length is zero, the returned array is empty and has a zero length. Si esta instancia es null o una cadena vacía (""), la matriz devuelta está vacía y tiene una longitud cero.If this instance is null or an empty string (""), the returned array is empty and has a zero length.

Para crear una matriz de bytes que contiene los caracteres codificados en una parte de una cadena, cree una instancia adecuado Encoding objeto y llamar a su GetBytes(String, Int32, Int32, Byte[], Int32) método.To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate Encoding object and call its GetBytes(String, Int32, Int32, Byte[], Int32) method. Algunas de las codificaciones estándares disponibles en .NET incluyen:Some of the standard encodings available in .NET include:

CodificaciónEncoding ObjectObject
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Para obtener más información, consulte codificación de caracteres en .NET.For more information, see Character Encoding in .NET.

Consulte también:

Se aplica a