Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método String.CopyTo

Copia um número especificado de caracteres de uma posição especificada nesta instância para uma posição especificada em um array de caracteres Unicode.

Namespace:  System
Assembly:  mscorlib (em mscorlib.dll)

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

Parâmetros

sourceIndex
Tipo: System.Int32
O índice do primeiro caractere nesse caso a ser copiada.
destination
Tipo: System.Char[]
Uma matriz de caracteres Unicode em que os caracteres são copiados nesse caso.
destinationIndex
Tipo: System.Int32
O índice em destination em que a operação de cópia é iniciada.
count
Tipo: System.Int32
O número de caracteres nesse caso a copiar a destination.

ExceçãoCondição
ArgumentNullException

destination é null.

ArgumentOutOfRangeException

sourceIndex, destinationIndex, ou count são negativos

- ou -

sourceIndex não identifica uma posição na instância atual.

-ou-

destinationIndex não identifica um índice válido na matriz de destination .

-ou-

count for maior que o comprimento da subcadeia de caracteres de startIndex ao final desta instância

- ou -

count for maior que o comprimento de subarray de destinationIndex ao final da matriz de destination .

Esse método copia caracteres de count da posição de sourceIndex dessa instância para a posição de destinationIndex de matriz de caractere de destination . Esse método não redimensionar a matriz de caractere de destination ; deve ter um número suficiente de elementos para acomodar os caracteres copiados ou o método gerará ArgumentOutOfRangeException.

sourceIndex e destinationIndex zero são baseados.

O exemplo a seguir demonstra o método de 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 );
    }
}
// The example displays the following output:
//       The initial array
//       The changed array
//       Thedifferentarray


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft