Esta documentación está archivada y no tiene mantenimiento.

String.CopyTo (Método)

Copia un número especificado de caracteres situados en una posición especificada de la instancia en una posición determinada de una matriz de caracteres Unicode.

Espacio de nombres: System
Ensamblado: mscorlib (en mscorlib.dll)

public void CopyTo (
	int sourceIndex,
	char[] destination,
	int destinationIndex,
	int count
)
public void CopyTo (
	int sourceIndex, 
	char[] destination, 
	int destinationIndex, 
	int count
)
public function CopyTo (
	sourceIndex : int, 
	destination : char[], 
	destinationIndex : int, 
	count : int
)

Parámetros

sourceIndex

Posición de carácter en la instancia en cuestión.

destination

Matriz de caracteres Unicode.

destinationIndex

Elemento de la matriz de destination.

count

Número de caracteres de la instancia en cuestión que se van a copiar en destination.

Tipo de excepciónCondición

ArgumentNullException

El valor de destination es referencia de objeto null (Nothing en Visual Basic).

ArgumentOutOfRangeException

sourceIndex, destinationIndex o count son valores negativos

O bien

count es mayor que la longitud de la subcadena desde startIndex hasta el final de la instancia en cuestión.

O bien

count es mayor que la longitud de la submatriz desde destinationIndex hasta el final de destination.

Los caracteres de count se copian desde la posición correspondiente a sourceIndex de la instancia en cuestión hasta la posición correspondiente a destinationIndex de destination.

sourceIndex y destinationIndex se basan en cero.

En el siguiente ejemplo de código se muestra el método CopyTo.

using System;

public class CopyToTest {
    public static void Main() {

        // Embed an array of characters in a string
        string strSource = "changed";
    char [] destination = { 'T', 'h', 'e', ' ', 'i', 'n', 'i', 't', 'i', 'a', 'l', ' ',
                'a', 'r', 'r', 'a', 'y' };

        // Print the char array
        Console.WriteLine( destination );

        // Embed the source string in the destination string
        strSource.CopyTo ( 0, destination, 4, strSource.Length );

        // Print the resulting array
        Console.WriteLine( destination );

        strSource = "A different string";

        // Embed only a section of the source string in the destination
        strSource.CopyTo ( 2, destination, 3, 9 );

        // Print the resulting array
        Console.WriteLine( destination );
    }
}

import System.*;

public class CopyToTest
{
    public static void main(String[] args)
    {
        // Embed an array of characters in a string
        String strSource = "changed";
        char destination[] =  { 'T', 'h', 'e', ' ', 'i', 'n', 'i', 't', 'i', 
            'a', 'l', ' ', 'a', 'r', 'r', 'a', 'y' };
        // Print the char array
        Console.WriteLine(destination);
        // Embed the source string in the destination string
        strSource.CopyTo(0, destination, 4, strSource.get_Length());
        // Print the resulting array
        Console.WriteLine(destination);

        strSource = "A different string";
        // Embed only a section of the source string in the destination
        strSource.CopyTo(2, destination, 3, 9);
        // Print the resulting array
        Console.WriteLine(destination);
    } //main
} //CopyToTest

import System;

public class CopyToTest {
    public static function Main() : void {

        // Embed an array of characters in a string
        var strSource : String = "changed";
        var destination : char[] = "The initial array".ToCharArray();

        // Print the char array
        Console.WriteLine( destination );

        // Embed the source string in the destination string
        strSource.CopyTo ( 0, destination, 4, strSource.Length );

        // Print the resulting array
        Console.WriteLine( destination );

        strSource = "A different string";

        // Embed only a section of the source string in the destination
        strSource.CopyTo ( 2, destination, 3, 9 );

        // Print the resulting array
        Console.WriteLine( destination );
    }
}
CopyToTest.Main();

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: