ContextNodeCollection.CopyTo (Método)
Actualización: noviembre 2007
Copia todos los elementos del objeto ContextNodeCollection actual en la matriz unidimensional especificada, empezando en el índice de la matriz de destino especificado.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.dll)
Sintaxis
'Declaración
Public Sub CopyTo ( _
array As ContextNode(), _
index As Integer _
)
'Uso
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
)
Parámetros
- array
Tipo: array<Microsoft.Ink.ContextNode[]
Matriz unidimensional que constituye el destino de los elementos copiados de la colección. La matriz debe tener una indización de base cero.
- index
Tipo: System.Int32
Índice de base cero del parámetro array donde comienza la copia.
Comentarios
Los elementos se copian en el objeto Array en el mismo orden en que el enumerador recorre en iteración ContextNodeCollection.
Se produce una excepción en los casos siguientes:
El parámetro array es una referencia nullreferencia null (Nothing en Visual Basic).
El parámetro index es menor que cero.
El parámetro array es multidimensional.
El parámetro index es igual o mayor que la longitud del parámetro array.
El número de elementos de la colección es mayor que el espacio disponible comprendido desde el parámetro index hasta el final del parámetro array de destino.
El tipo de la colección se convierte automáticamente al tipo del parámetro array de destino. Sin embargo, este método únicamente copia elementos en matrices del mismo tipo que los elementos de la colección o en matrices de tipo Object. Al intentar realizar la copia en otro tipo de matriz, se produce una excepción InvalidCastException.
Este método está sincronizado.
Ejemplos
En el ejemplo siguiente se rellena parte de una matriz de objetos ContextNode con todos los párrafos que InkAnalyzer, theInkAnalyzer puede encontrar. Comienza en el elemento 1 (el segundo elemento de una matriz basada en cero) de la matriz de destino, paragraphArray, y deja vacío el primer elemento de la matriz de destino (con un índice 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);
Plataformas
Windows Vista
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión
.NET Framework
Compatible con: 3.0