Compartir a través de


ContextLinkCollection.CopyTo (Método)

Actualización: noviembre 2007

Copia todos los elementos del objeto ContextLinkCollection 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 ContextLink(), _
    index As Integer _
)
'Uso
Dim instance As ContextLinkCollection
Dim array As ContextLink()
Dim index As Integer

instance.CopyTo(array, index)
public void CopyTo(
    ContextLink[] array,
    int index
)
public:
void CopyTo(
    array<ContextLink^>^ array, 
    int index
)
public void CopyTo(
    ContextLink[] array,
    int index
)
public function CopyTo(
    array : ContextLink[], 
    index : int
)

Parámetros

  • array
    Tipo: array<Microsoft.Ink.ContextLink[]
    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 el objeto ContextLinkCollection.

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 sólo copia elementos en matrices del mismo tipo que los elementos de la colección o en matrices de tipo System.Object. Si se intenta copiar en otro tipo de matriz se genera una excepción System.InvalidCastException.

Este método está sincronizado.

Ejemplos

En el ejemplo siguiente se rellena parte de una matriz de objetos ContextLink con un objeto ContextLinkCollection, links. Comienza en elemento 1 (el segundo elemento de una matriz basada en cero) de la matriz de destino, linkArray, y deja vacío el primer elemento de la matriz de destino (con un índice 0).

Dim linkArray(theNode.Links.Count + 1) As ContextLink
theNode.Links.CopyTo(linkArray, 1)
ContextLink[] linkArray = new ContextLink[theNode.Links.Count + 1];
theNode.Links.CopyTo(linkArray, 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

Vea también

Referencia

ContextLinkCollection (Clase)

ContextLinkCollection (Miembros)

Microsoft.Ink (Espacio de nombres)