次の方法で共有


String.CopyTo メソッド

定義

オーバーロード

CopyTo(Span<Char>)

この文字列の内容をコピー先スパンにコピーします。

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

このインスタンスの指定位置から指定した数の文字を、Unicode 文字の配列内の指定位置へコピーします。

CopyTo(Span<Char>)

ソース:
String.cs
ソース:
String.cs
ソース:
String.cs

この文字列の内容をコピー先スパンにコピーします。

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

パラメーター

destination
Span<Char>

この文字列の内容をコピーするスパン。

例外

変換先のスパンは、ソース文字列よりも短くなります。

適用対象

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

ソース:
String.cs
ソース:
String.cs
ソース:
String.cs

このインスタンスの指定位置から指定した数の文字を、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)

パラメーター

sourceIndex
Int32

コピーする、このインスタンス内の最初の文字のインデックス。

destination
Char[]

このインスタンスの文字のコピー先となる Unicode 文字の配列。

destinationIndex
Int32

コピー操作を開始する destination のインデックス。

count
Int32

destination へコピーされるこのインスタンスの文字の数。

例外

destinationnullです。

sourceIndexdestinationIndex、または count が負の値です。

または

sourceIndex が現在のインスタンス内の位置を識別していません。

または

destinationIndex が、 destination 配列内の有効なインデックスを識別していません。

または

count は、このインスタンスの sourceIndex から末尾までの部分文字列の長さを超えています。

または

count は、destination 配列の destinationIndex から末尾までの部分配列の長さを超えています。

CopyToメソッドの例を次に示します。

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

注釈

このメソッドは、countこのインスタンスの位置からsourceIndex文字配列のdestination位置に文字をdestinationIndexコピーします。 このメソッドは、文字配列のサイズを destination 変更しません。コピーされた文字を格納するのに十分な数の要素が必要です。または、 メソッドが を ArgumentOutOfRangeExceptionスローします。

sourceIndexdestinationIndex は 0 から始まります。

こちらもご覧ください

適用対象