String.CopyTo Método

Referência

Definição

Namespace:: System

Assemblies:: netstandard.dll, System.Runtime.dll

Assemblies:: mscorlib.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

CopyTo(Span<Char>)	Copia o conteúdo dessa cadeia de caracteres para o intervalo de destino.
CopyTo(Int32, Char[], Int32, Int32)	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.

CopyTo(Span<Char>)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Copia o conteúdo dessa cadeia de caracteres para o intervalo de destino.

public:
 void CopyTo(Span<char> destination);

public void CopyTo(Span<char> destination);

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

Public Sub CopyTo (destination As Span(Of Char))

Parâmetros

destination: Span<Char>

O intervalo no qual copiar o conteúdo dessa cadeia de caracteres.

Exceções

ArgumentException

O intervalo de destino é menor que a cadeia de caracteres de origem.

Aplica-se a

.NET 10 e outras versões

Produto	Versões
.NET	6, 7, 8, 9, 10

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

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

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.

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

O índice do primeiro caractere nessa instância a ser copiada.

destination: Char[]

Uma matriz de caracteres Unicode para a qual caracteres nessa instância são copiados.

destinationIndex: Int32

O índice em destination no qual a operação de cópia é iniciada.

count: Int32

O número de caracteres nesta instância a serem copiados para destination.

Exceções

ArgumentNullException

destination é null.

ArgumentOutOfRangeException

sourceIndex, destinationIndexou count é negativo

- ou -

sourceIndex não identifica uma posição na instância atual.

- ou -

destinationIndex não identifica um índice válido na matriz destination .

- ou -

count é maior que o comprimento da subcadeia de sourceIndex até final desta instância

- ou -

count é maior que o comprimento da submatriz de destinationIndex até final da matriz destination.

Exemplos

O exemplo a seguir demonstra o CopyTo método.

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

// Embed an array of characters in a string
let strSource = "changed"
let destination = 
    [| 'T'; 'h'; 'e'; ' '; 'i'; 'n'; 'i'; 't'; 'i'; 'a'; 'l'; ' ';
       'a'; 'r'; 'r'; 'a'; 'y' |]

// Print the char array
printfn $"{destination}"

// Embed the source string in the destination string
strSource.CopyTo( 0, destination, 4, strSource.Length)

// Print the resulting array
printfn $"{destination}"

let strSource2 = "A different string"

// Embed only a section of the source string in the destination
strSource2.CopyTo( 2, destination, 3, 9)

// Print the resulting array
printfn $"{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 caracteres count da sourceIndex posição dessa instância para a destinationIndex posição da matriz de destination caracteres. Esse método não redimensiona a 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.

sourceIndex e destinationIndex são baseados em zero.

Confira também

Aplica-se a

.NET 10 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Compartilhar via

String.CopyTo Método

Definição

Sobrecargas

CopyTo(Span<Char>)

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais