StringBuilder.CopyTo Méthode

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Surcharges

Nom	Description
CopyTo(Int32, Span<Char>, Int32)	Copie les caractères d’un segment spécifié de cette instance dans une étendue de destination Char .
CopyTo(Int32, Char[], Int32, Int32)	Copie les caractères d’un segment spécifié de cette instance vers un segment spécifié d’un tableau de destination Char .

CopyTo(Int32, Span<Char>, Int32)

Source:

StringBuilder.cs

Copie les caractères d’un segment spécifié de cette instance dans une étendue de destination Char .

public:
 void CopyTo(int sourceIndex, Span<char> destination, int count);

public void CopyTo(int sourceIndex, Span<char> destination, int count);

member this.CopyTo : int * Span<char> * int -> unit

Public Sub CopyTo (sourceIndex As Integer, destination As Span(Of Char), count As Integer)

Paramètres

sourceIndex

Int32

Position de départ dans cette instance à partir de laquelle les caractères seront copiés. L’index est basé sur zéro.

destination

Span<Char>

Étendue accessible en écriture dans laquelle les caractères seront copiés.

count

Int32

Nombre de caractères à copier.

Remarques

La CopyTo méthode est destinée à être utilisée dans la situation rare lorsque vous devez copier efficacement les sections successives d’un StringBuilder objet dans une étendue.

Par exemple, votre code peut remplir un StringBuilder objet avec un grand nombre de caractères, puis utiliser la CopyTo méthode pour copier de petits morceaux successifs de l’objet StringBuilder dans une étendue où les éléments sont traités. Lorsque toutes les données de l’objet StringBuilder sont traitées, la taille de l’objet StringBuilder est définie sur zéro et le cycle est répété.

CopyTo(Int32, Char[], Int32, Int32)

Source:

StringBuilder.cs

Copie les caractères d’un segment spécifié de cette instance vers un segment spécifié d’un tableau de destination Char .

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

Position de départ dans cette instance à partir de laquelle les caractères seront copiés. L’index est basé sur zéro.

destination

Char[]

Tableau où les caractères seront copiés.

destinationIndex

Int32

Position de départ dans destination laquelle les caractères seront copiés. L’index est basé sur zéro.

count

Int32

Nombre de caractères à copier.

Exceptions

ArgumentNullException

destination a la valeur null.

ArgumentOutOfRangeException

sourceIndex, destinationIndexou , est countinférieur à zéro.

- ou -

sourceIndex est supérieur à la longueur de cette instance.

ArgumentException

sourceIndex + count est supérieur à la longueur de cette instance.

- ou -

destinationIndex + count est supérieur à la longueur de destination.

Exemples

L’exemple suivant illustre la CopyTo méthode.

// This example demonstrates the CopyTo(Int32, Char[], Int32, Int32) method.

// Typically the destination array is small, preallocated, and global while
// the StringBuilder is large with programmatically defined data.
// However, for this example both the array and StringBuilder are small
// and the StringBuilder has predefined data.

using System;
using System.Text;

class Sample
{
    protected static char[] dest = new char[6];
    public static void Main()
    {
    StringBuilder src = new StringBuilder("abcdefghijklmnopqrstuvwxyz!");
    dest[1] = ')';
    dest[2] = ' ';

// Copy the source to the destination in 9 pieces, 3 characters per piece.

    Console.WriteLine("\nPiece) Data:");
    for(int ix = 0; ix < 9; ix++)
        {
        dest[0] = ix.ToString()[0];
        src.CopyTo(ix * 3, dest, 3, 3);
        Console.Write("    ");
        Console.WriteLine(dest);
        }
    }
}
/*
This example produces the following results:

Piece) Data:
    0) abc
    1) def
    2) ghi
    3) jkl
    4) mno
    5) pqr
    6) stu
    7) vwx
    8) yz!
*/

// This example demonstrates the CopyTo(Int32, Char[], Int32, Int32) method.

// Typically the destination array is small, preallocated, and global while
// the StringBuilder is large with programmatically defined data.
// However, for this example both the array and StringBuilder are small
// and the StringBuilder has predefined data.

open System.Text

let dest = Array.zeroCreate 6

let src = StringBuilder "abcdefghijklmnopqrstuvwxyz!"
dest[1] <- ')'
dest[2] <- ' '

// Copy the source to the destination in 9 pieces, 3 characters per piece.

printfn "\Piece) Data:"
for i = 0 to 8 do
    dest[0] <- (string i)[0]
    src.CopyTo(i * 3, dest, 3, 3)
    printfn $"    {dest}"

// This example produces the following results:
//       Piece) Data:
//           0) abc
//           1) def
//           2) ghi
//           3) jkl
//           4) mno
//           5) pqr
//           6) stu
//           7) vwx
//           8) yz!

' Typically the destination array is small, preallocated, and global while 
' the StringBuilder is large with programmatically defined data. 
' However, for this example both the array and StringBuilder are small 
' and the StringBuilder has predefined data.

Imports System.Text

Class Sample
   Protected Shared dest(5) As Char
   
   Public Shared Sub Main()
      Dim src As New StringBuilder("abcdefghijklmnopqrstuvwxyz!")
      dest(1) = ")"c
      dest(2) = " "c
      
      ' Copy the source to the destination in 9 pieces, 3 characters per piece.
      Console.WriteLine(vbCrLf & "Piece) Data:")
      Dim ix As Integer
      For ix = 0 To 8
         dest(0) = ix.ToString()(0)
         src.CopyTo(ix * 3, dest, 3, 3)
         Console.Write("    ")
         Console.WriteLine(dest)
      Next ix
   End Sub
End Class
'
' This example produces the following results:
'
' Piece) Data:
'     0) abc
'     1) def
'     2) ghi
'     3) jkl
'     4) mno
'     5) pqr
'     6) stu
'     7) vwx
'     8) yz!

Remarques

La CopyTo méthode est destinée à être utilisée dans la situation rare lorsque vous devez copier efficacement les sections successives d’un StringBuilder objet dans un tableau. Le tableau doit être une taille fixe, préallouée, réutilisable et éventuellement accessible globalement.

Par exemple, votre code peut remplir un StringBuilder objet avec un grand nombre de caractères, puis utiliser la CopyTo méthode pour copier de petits morceaux successifs de l’objet StringBuilder dans un tableau où les éléments sont traités. Lorsque toutes les données de l’objet StringBuilder sont traitées, la taille de l’objet StringBuilder est définie sur zéro et le cycle est répété.