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

Definizione

Copia un numero definito di caratteri da una posizione specificata in questa istanza in una posizione specificata in una matrice di caratteri 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)

Parametri

sourceIndex
Int32

Indice del primo carattere nell'istanza da copiare.The index of the first character in this instance to copy.

destination
Char[]

Matrice di caratteri Unicode in cui vengono copiati i caratteri di questa istanza.An array of Unicode characters to which characters in this instance are copied.

destinationIndex
Int32

Indice nel parametro destination in corrispondenza del quale inizia l'operazione di copia.The index in destination at which the copy operation begins.

count
Int32

Numero di caratteri dell'istanza da copiare in destination.The number of characters in this instance to copy to destination.

Eccezioni

destination è null.destination is null.

sourceIndex, destinationIndex o count è negativo.sourceIndex, destinationIndex, or count is negative -oppure--or- sourceIndex non identifica una posizione nell'istanza corrente.sourceIndex does not identify a position in the current instance.

-oppure--or- destinationIndex non identifica un indice valido nella matrice destination.destinationIndex does not identify a valid index in the destination array.

-oppure--or- count è maggiore della lunghezza della sottostringa compresa fra l'indice specificato nel parametro sourceIndex e la fine dell'istanza.count is greater than the length of the substring from sourceIndex to the end of this instance -oppure--or- count è maggiore della lunghezza della sottomatrice compresa fra il valore del parametro destinationIndex e la fine della matrice destination.count is greater than the length of the subarray from destinationIndex to the end of the destination array.

Esempi

Nell'esempio seguente viene illustrato il metodo CopyTo.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

Commenti

Questo metodo copia count caratteri dalla posizione sourceIndex di questa istanza alla posizione destinationIndex della matrice di caratteri destination.This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. Questo metodo non ridimensiona la matrice di caratteri destination; deve avere un numero sufficiente di elementi per contenere i caratteri copiati oppure il metodo genera un'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 sono in base zero.sourceIndex and destinationIndex are zero-based.

Si applica a

Vedi anche