現在の Recognizers コレクションのすべての要素を、指定された 1 次元配列の、指定された配列インデックスから開始する位置にコピーします。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Sub CopyTo ( _
array As Array, _
index As Integer _
)
'使用
Dim instance As Recognizers
Dim array As Array
Dim index As Integer
instance.CopyTo(array, index)
public void CopyTo(
Array array,
int index
)
public:
virtual void CopyTo(
Array^ array,
int index
) sealed
public final void CopyTo(
Array array,
int index
)
public final function CopyTo(
array : Array,
index : int
)
パラメータ
- array
型 : System.Array
コレクションからの要素のコピー先である 1 次元配列。この配列では、0 から始まるインデックスを使用する必要があります。
- index
型 : System.Int32
配列パラメータ内の、コピーを開始する位置を表すインデックス番号 (0 から始まる)。
実装
ICollection.CopyTo(Array, Int32)
解説
Array オブジェクトに要素がコピーされる順序は、列挙子が Recognizers の繰り返し処理を行うときの順序と同じです。
次の場合は、例外がスローされます。
array パラメータが nullnull 参照 (Visual Basic では Nothing) (Microsoft® Visual Basic® .NET では Nothing) 参照の場合。
index パラメータが 0 未満の場合。
array パラメータが多次元の場合。
index パラメータが array パラメータの長さ以上の場合。
コレクション内の要素の数が、index パラメータからコピー先の配列パラメータの末尾までに格納できる数を超えている場合。
コレクションの型は、コピー先の array パラメータの型に自動的にキャストされます。ただし、このメソッドでは、コレクションの要素と同じ型の配列、または Object 型の配列にのみ要素がコピーされます。別の型の配列にコピーしようとすると、InvalidCastException 例外がスローされます。
このメソッドは同期されます。
例
この C# の例では、Recognizers コレクション theRecognizers を作成して、配列 theCopy にコピーします。この配列のサイズは、theRecognizers のメンバの数と等しくなるように設定します。
//Create the Recognizers collection
theRecognizers = new Recognizers();
//Create the array and set the size equal to the size of the Recognizers collection
theCopy = new Recognizer[theRecognizers.Count];
//Copy the Recognizers collection into the array, starting at index of 0
theRecognizers.CopyTo(theCopy,0);
この Visual Basic .NET の例では、Recognizers コレクション theRecognizers を作成して、配列 theCopy にコレクションをコピーします。この配列のサイズは、theRecognizers のメンバの数と等しくなるように設定します。
'Create the Recognizers Collection.
Dim theRecognizers As Recognizers
'Create the array and set the size equal to the size of the Recognizers collection.
Dim theCopy(theRecognizers.Count) As Recognizer
'Copy the Recognizers collection into the array, starting at index of 0
theRecognizers.CopyTo(theCopy, 0)
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0