Metodo ContextNodeCollection.CopyTo

Articolo
10/29/2008

Aggiornamento: novembre 2007

Copia tutti gli elementi dell'oggetto ContextNodeCollection corrente nella matrice unidimensionale specificata, a partire dall'indice della matrice di destinazione specificato.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Sub CopyTo ( _
    array As ContextNode(), _
    index As Integer _
)
'Utilizzo
Dim instance As ContextNodeCollection
Dim array As ContextNode()
Dim index As Integer

instance.CopyTo(array, index)

public void CopyTo(
    ContextNode[] array,
    int index
)

public:
void CopyTo(
    array<ContextNode^>^ array, 
    int index
)

public void CopyTo(
    ContextNode[] array,
    int index
)

public function CopyTo(
    array : ContextNode[], 
    index : int
)

Parametri

array
Tipo: array<Microsoft.Ink.ContextNode[]
Matrice unidimensionale che rappresenta la destinazione per gli elementi copiati dall'insieme. La matrice deve avere indicizzazione in base zero.

index
Tipo: System.Int32
Indice in base zero del parametro array in corrispondenza del quale ha inizio la copia.

Note

Gli elementi vengono copiati nell'oggetto Array nello stesso ordine in cui l'enumeratore scorre l'oggetto ContextNodeCollection.

Viene generata un'eccezione nei casi seguenti:

Il parametro array è un riferimento nullriferimento null (Nothing in Visual Basic).
Il parametro index è minore di zero.
Il parametro array è multidimensionale.
Il parametro index è maggiore o uguale alla lunghezza del parametro array.
Il numero di elementi nell'insieme è maggiore dello spazio disponibile dal parametro index alla fine del parametro array di destinazione.

Viene eseguito automaticamente il cast del tipo dell'insieme al tipo del parametro array di destinazione. Tuttavia, questo metodo copia gli elementi solo nelle matrici dello stesso tipo degli elementi dell'insieme o nelle matrici di tipo Object. Il tentativo di copia in un altro tipo di matrice provoca la generazione di un'eccezione InvalidCastException.

Questo metodo è sincronizzato.

Esempi

Nell'esempio seguente, parte di una matrice di oggetti ContextNode viene riempita con tutti i paragrafi che un oggetto InkAnalyzer, theInkAnalyzer è in grado di individuare. Si inizia dall'elemento 1 (il secondo elemento in una matrice in base zero) della matrice di destinazione, paragraphArray e si lascia vuoto il primo elemento della matrice di destinazione (con indice 0).

Dim paragraphs As ContextNodeCollection = _
    theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Paragraph)
Dim paragraphArray(paragraphs.Count) As ContextNode
paragraphs.CopyTo(paragraphArray, 1)

            ContextNodeCollection paragraphs =
                theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Paragraph);
            ContextNode[] paragraphArray = new ContextNode[paragraphs.Count + 1];
            paragraphs.CopyTo(paragraphArray, 1);

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

ContextNodeCollection Classe

Membri ContextNodeCollection

Spazio dei nomi Microsoft.Ink

Condividi tramite