String.CopyTo-Methode

Kopiert eine angegebene Anzahl von Zeichen von einer angegebenen Position in dieser Instanz an eine angegebene Position in einem Array von Unicode-Zeichen.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub CopyTo ( _
    sourceIndex As Integer, _
    destination As Char(), _
    destinationIndex As Integer, _
    count As Integer _
)
'Usage
Dim instance As String
Dim sourceIndex As Integer
Dim destination As Char()
Dim destinationIndex As Integer
Dim count As Integer

instance.CopyTo(sourceIndex, destination, destinationIndex, count)

public void CopyTo (
    int sourceIndex,
    char[] destination,
    int destinationIndex,
    int count
)

public:
void CopyTo (
    int sourceIndex, 
    array<wchar_t>^ destination, 
    int destinationIndex, 
    int count
)

public void CopyTo (
    int sourceIndex, 
    char[] destination, 
    int destinationIndex, 
    int count
)

public function CopyTo (
    sourceIndex : int, 
    destination : char[], 
    destinationIndex : int, 
    count : int
)

Parameter

• sourceIndex
  Eine Zeichenposition innerhalb dieser Instanz.

• destination
  Ein Array von Unicode-Zeichen.

• destinationIndex
  Ein Arrayelement in destination.

• count
  Die Anzahl der Zeichen in dieser Instanz, die nach destination kopiert werden sollen.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	destination ist NULL (Nothing in Visual Basic).
ArgumentOutOfRangeException	sourceIndex, destinationIndex oder count ist negativ. - oder - count ist größer als die Länge der Teilzeichenfolge von startIndex bis zum Ende dieser Instanz. - oder - count ist größer als die Länge des Teilarrays von destinationIndex bis zum Ende von destination.

Hinweise

Es werden count Zeichen von der Position sourceIndex dieser Instanz an die Position destinationIndex von destination kopiert.

sourceIndex und destinationIndex sind nullbasiert.

Beispiel

Im folgenden Codebeispiel wird die CopyTo-Methode veranschaulicht.

Imports System

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 'Main
End Class 'CopyToTest

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

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

import System.*;

public class CopyToTest
{
    public static void main(String[] args)
    {
        // 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.get_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);
    } //main
} //CopyToTest

import System;

public class CopyToTest {
    public static function Main() : void {

        // Embed an array of characters in a string
        var strSource : String = "changed";
        var destination : char[] = "The initial array".ToCharArray();

        // 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 );
    }
}
CopyToTest.Main();

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

String-Klasse
String-Member
System-Namespace
Char-Struktur
Int32-Struktur
Insert
Substring