String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) String.CopyTo(Int32, Char[], Int32, Int32) Method

Definição

Copia um número especificado de caracteres de uma posição especificada nesta instância para uma posição especificada em uma matriz de caracteres Unicode.Copies a specified number of characters from a specified position in this instance to a specified position in an array of Unicode characters.

public:
 void CopyTo(int sourceIndex, cli::array <char> ^ destination, int destinationIndex, int count);
public void CopyTo (int sourceIndex, char[] destination, int destinationIndex, int count);
member this.CopyTo : int * char[] * int * int -> unit
Public Sub CopyTo (sourceIndex As Integer, destination As Char(), destinationIndex As Integer, count As Integer)

Parâmetros

sourceIndex
Int32 Int32 Int32 Int32

O índice do primeiro caractere nessa instância a ser copiada.The index of the first character in this instance to copy.

destination
Char[]

Uma matriz de caracteres Unicode para a qual caracteres nessa instância são copiados.An array of Unicode characters to which characters in this instance are copied.

destinationIndex
Int32 Int32 Int32 Int32

O índice em destination no qual a operação de cópia é iniciada.The index in destination at which the copy operation begins.

count
Int32 Int32 Int32 Int32

O número de caracteres nesta instância a serem copiados para destination.The number of characters in this instance to copy to destination.

Exceções

sourceIndex, destinationIndex ou count é negativosourceIndex, destinationIndex, or count is negative - ou --or- sourceIndex não identifica uma posição na instância atual.sourceIndex does not identify a position in the current instance.

- ou --or- destinationIndex não identifica um índice válido na matriz destination.destinationIndex does not identify a valid index in the destination array.

- ou --or- count é maior que o comprimento da subcadeia de sourceIndex até final desta instânciacount is greater than the length of the substring from sourceIndex to the end of this instance - ou --or- count é maior que o comprimento da submatriz de destinationIndex até final da matriz destination.count is greater than the length of the subarray from destinationIndex to the end of the destination array.

Exemplos

O exemplo a seguir demonstra o CopyTo método.The following example demonstrates the CopyTo method.

using namespace System;
int main()
{
   
   // Embed an array of characters in a string
   String^ strSource = "changed";
   array<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
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
Public Class CopyToTest
    Public Shared Sub Main()
        ' Embed an array of characters in a string
        Dim strSource As String = "changed"
        Dim destination As Char() = {"T"c, "h"c, "e"c, " "c, "i"c, "n"c, "i"c, _
                    "t"c, "i"c, "a"c, "l"c, " "c, "a"c, "r"c, "r"c, "a"c, "y"c}

        ' 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)
    End Sub 
End Class 
' The example displays the following output:
'       The initial array
'       The changed array
'       Thedifferentarray

Comentários

Esse método copia count caracteres da sourceIndex posição dessa instância para o destinationIndex posição do destination matriz de caracteres.This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. Esse método não redimensiona o destination matriz de caracteres; ele deve ter um número suficiente de elementos para acomodar os caracteres copiados ou o método lança um ArgumentOutOfRangeException.This method does not resize the destination character array; it must have a sufficient number of elements to accommodate the copied characters or the method throws an ArgumentOutOfRangeException.

sourceIndex e destinationIndex são baseados em zero.sourceIndex and destinationIndex are zero-based.

Aplica-se a

Veja também