RecognitionAlternates.CopyTo 方法

從指定的目的陣列索引開始，將目前 RecognitionAlternates 集合的所有元素都複製到指定的一維陣列。

命名空間：  Microsoft.Ink
組件：  Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'用途
Dim instance As RecognitionAlternates
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
  一維陣列，這個陣列是從集合複製過來的元素之目的陣列。此陣列必須具有以零起始的索引。

• index
  型別：System.Int32
  陣列參數中以零起始的索引，位於複製開始的位置。

實作

ICollection.CopyTo(Array, Int32)

備註

元素會以列舉值逐一查看 RecognitionAlternates 的相同順序，複製到 Array (英文) 物件中。

如果發生下列情況，會擲回例外狀況 (Exception)：

• array 參數為 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Microsoft® Visual Basic® .NET 中為 Nothing) 參考。

• index 參數小於零。

• array 參數為多維。

• index 參數等於或大於 array 參數的長度。

• 集合中元素的數目大於從 index 參數至目的 array 參數結尾的可用空間。

集合的型別會自動轉型 (Cast) 為目的 array 參數的型別。不過，這個方法只會將元素複製到與集合元素相同型別的陣列或 Object (英文) 型別的陣列。嘗試複製到另一個陣列型別會造成擲回 InvalidCastException (英文) 例外狀況。

這個方法會同步處理。

範例

這個範例會使用 CopyTo 方法，將 RecognitionAlternates 集合的整個內容填入 RecognitionAlternate 物件的陣列。

' get the RecognitionAlternates from the RecognitionResult object
Dim mAlternates As RecognitionAlternates = mRecognitionResult.GetAlternatesFromSelection()
'Create the array to copy alternates into
Dim theCopies(mAlternates.Count - 1) As RecognitionAlternate
'Copy the alternates to the array
mAlternates.CopyTo(theCopies, 0)

// get the RecognitionAlternates from the RecognitionResult object
RecognitionAlternates mAlternates = mRecognitionResult.GetAlternatesFromSelection();
//Create the array to copy alternates into
RecognitionAlternate[] theCopies = new RecognitionAlternate[mAlternates.Count];
//Copy the alternates to the array
mAlternates.CopyTo(theCopies, 0);

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

RecognitionAlternates 類別

RecognitionAlternates 成員

Microsoft.Ink 命名空間