String.CopyTo(Int32, Char[], Int32, Int32) Méthode

Définition

Copie un nombre spécifié de caractères à partir d'une position spécifiée dans cette instance vers une position spécifiée dans un tableau de caractères 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)

Paramètres

sourceIndex
Int32

Index du premier caractère de cette instance à copier.The index of the first character in this instance to copy.

destination
Char[]

Tableau de caractères Unicode dans lequel les caractères de cette instance sont copiés.An array of Unicode characters to which characters in this instance are copied.

destinationIndex
Int32

Index de destination au niveau duquel commence l'opération de copie.The index in destination at which the copy operation begins.

count
Int32

Nombre de caractères dans cette instance à copier vers destination.The number of characters in this instance to copy to destination.

Exceptions

destination a la valeur null.destination is null.

sourceIndex, destinationIndex ou count est un nombre négatif.sourceIndex, destinationIndex, or count is negative

- ou --or-

sourceIndex n’identifie pas une position dans l’instance actuelle.sourceIndex does not identify a position in the current instance.

- ou --or-

destinationIndex n’identifie pas un index valide dans le tableau destination.destinationIndex does not identify a valid index in the destination array.

- ou --or-

count est supérieur à la longueur de la sous-chaîne de sourceIndex jusqu’à la fin de cette instance.count is greater than the length of the substring from sourceIndex to the end of this instance

- ou --or-

count est supérieur à la longueur du sous-tableau de destinationIndex jusqu’à la fin du tableau destination.count is greater than the length of the subarray from destinationIndex to the end of the destination array.

Exemples

L’exemple suivant illustre la CopyTo méthode.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

Remarques

Cette méthode copie les count caractères à partir de la sourceIndex position de cette instance jusqu’à la destinationIndex position du destination tableau de caractères.This method copies count characters from the sourceIndex position of this instance to the destinationIndex position of destination character array. Cette méthode ne redimensionne pas le destination tableau de caractères ; elle doit avoir un nombre suffisant d’éléments pour prendre en charge les caractères copiés, sinon la méthode lève une 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 et destinationIndex sont de base zéro.sourceIndex and destinationIndex are zero-based.

S’applique à

Voir aussi