String.CopyTo Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: mscorlib.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

CopyTo(Span<Char>)	Copia il contenuto di questa stringa nell'intervallo di destinazione.
CopyTo(Int32, Char[], Int32, Int32)	Copia un numero definito di caratteri da una posizione specificata in questa istanza in una posizione specificata in una matrice di caratteri Unicode.

CopyTo(Span<Char>)

Origine:: String.cs

Origine:: String.cs

Origine:: String.cs

Copia il contenuto di questa stringa nell'intervallo di destinazione.

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))

Parametri

destination: Span<Char>

Intervallo in cui copiare il contenuto di questa stringa.

Eccezioni

ArgumentException

L'intervallo di destinazione è più breve della stringa di origine.

Si applica a

.NET 10 e altre versioni

Prodotto	Versioni
.NET	6, 7, 8, 9, 10

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

Origine:: String.cs

Origine:: String.cs

Origine:: String.cs

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

Parametri

sourceIndex: Int32

Indice del primo carattere nell'istanza da copiare.

destination: Char[]

Matrice di caratteri Unicode in cui vengono copiati i caratteri di questa istanza.

destinationIndex: Int32

Indice nel parametro destination in corrispondenza del quale inizia l'operazione di copia.

count: Int32

Numero di caratteri dell'istanza da copiare in destination.

Eccezioni

ArgumentNullException

destination è null.

ArgumentOutOfRangeException

sourceIndex, destinationIndex o count è negativo.

-oppure-

sourceIndex non identifica una posizione nell'istanza corrente.

-oppure-

destinationIndex non identifica un indice valido nella matrice destination.

-oppure-

count è maggiore della lunghezza della sottostringa compresa fra l'indice specificato nel parametro sourceIndex e la fine dell'istanza.

-oppure-

count è maggiore della lunghezza della sottomatrice compresa fra il valore del parametro destinationIndex e la fine della matrice destination.

Esempio

Nell'esempio seguente viene illustrato il CopyTo metodo.

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

Commenti

Questo metodo copia count i caratteri dalla sourceIndex posizione di questa istanza alla destinationIndex posizione della matrice di destination caratteri. Questo metodo non ridimensiona la destination matrice di caratteri. Deve avere un numero sufficiente di elementi per contenere i caratteri copiati o il metodo genera un ArgumentOutOfRangeExceptionoggetto .

sourceIndex e destinationIndex sono basati su zero.

Vedi anche

Si applica a

.NET 10 e altre versioni

Prodotto	Versioni
.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

Condividi tramite

String.CopyTo Metodo

Definizione

Overload

CopyTo(Span<Char>)

Parametri

Eccezioni

Si applica a

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

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive