StringBuilder.CopyTo Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

System.Runtime.dll

Przeciążenia

CopyTo(Int32, Span<Char>, Int32)	Kopiuje znaki z określonego segmentu tego wystąpienia do zakresu docelowego Char .
CopyTo(Int32, Char[], Int32, Int32)	Kopiuje znaki z określonego segmentu tego wystąpienia do określonego segmentu tablicy docelowej Char .

CopyTo(Int32, Span<Char>, Int32)

Źródło:

StringBuilder.cs

Kopiuje znaki z określonego segmentu tego wystąpienia do zakresu docelowego 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)

Parametry

sourceIndex

Int32

Pozycja początkowa w tym wystąpieniu, z którego będą kopiowane znaki. Jest to indeks zaczynający się od zera.

destination

Span<Char>

Zapisywalny zakres, w którym będą kopiowane znaki.

count

Int32

Liczba znaków do skopiowania.

Uwagi

Metoda CopyTo ma być używana w rzadkich sytuacjach, gdy trzeba efektywnie skopiować kolejne sekcje StringBuilder obiektu do zakresu.

Na przykład kod może wypełnić StringBuilder obiekt dużą liczbą znaków, a następnie użyć CopyTo metody do skopiowania małych, kolejnych fragmentów StringBuilder obiektu do zakresu, w którym są przetwarzane elementy. Gdy wszystkie dane w StringBuilder obiekcie są przetwarzane, rozmiar StringBuilder obiektu jest ustawiony na zero, a cykl jest powtarzany.

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

Źródło:

StringBuilder.cs

Kopiuje znaki z określonego segmentu tego wystąpienia do określonego segmentu tablicy docelowej 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)

Parametry

sourceIndex

Int32

Pozycja początkowa w tym wystąpieniu, z którego będą kopiowane znaki. Jest to indeks zaczynający się od zera.

destination

Char[]

Tablica, w której będą kopiowane znaki.

destinationIndex

Int32

Pozycja początkowa, w destination której będą kopiowane znaki. Jest to indeks zaczynający się od zera.

count

Int32

Liczba znaków do skopiowania.

Wyjątki

ArgumentNullException

destination to null.

ArgumentOutOfRangeException

sourceIndex, destinationIndexlub count, jest mniejszy niż zero.

-lub-

sourceIndex jest większa niż długość tego wystąpienia.

ArgumentException

sourceIndex + count jest większa niż długość tego wystąpienia.

-lub-

destinationIndex + count jest większa niż długość obiektu destination.

Przykłady

W poniższym przykładzie pokazano metodę CopyTo .

// 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 namespace System;
using namespace System::Text;

int main()
{
   array<Char>^dest = gcnew array<Char>(6);
   StringBuilder^ src = gcnew 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.

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!

Uwagi

Metoda CopyTo ma być używana w rzadkiej sytuacji, gdy trzeba efektywnie skopiować kolejne sekcje StringBuilder obiektu do tablicy. Tablica powinna być stałym rozmiarem, wstępnie przeniesionym, wielokrotnego użytku i ewentualnie dostępnym globalnie.

Na przykład kod może wypełnić StringBuilder obiekt dużą liczbą znaków, a następnie użyć CopyTo metody do skopiowania małych, kolejnych fragmentów StringBuilder obiektu do tablicy, w której są przetwarzane elementy. Gdy wszystkie dane w StringBuilder obiekcie są przetwarzane, rozmiar StringBuilder obiektu jest ustawiony na zero, a cykl jest powtarzany.