Compartir a través de


ExtendedProperties.CopyTo (Método)

Actualización: noviembre 2007

Copia todos los elementos de la colección ExtendedProperties actual en la matriz unidimensional especificada, a partir del índice especificado de la matriz de destino.

Espacio de nombres:  Microsoft.Ink
Ensamblado:  Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'Uso
Dim instance As ExtendedProperties
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
)

Parámetros

  • array
    Tipo: System.Array
    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 de la matriz donde comienza la copia.

Implementaciones

ICollection.CopyTo(Array, Int32)

Comentarios

Los elementos se copian en el objeto Array en el mismo orden en que el enumerador recorre en iteración el objeto ExtendedProperties.

Se produce una excepción si:

  • El parámetro de la matriz es una referencia nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft® Visual Basic® .NET).

  • El parámetro de índice es menor que cero.

  • El parámetro de la matriz es multidimensional.

  • El parámetro de índice es igual o mayor que la longitud del parámetro de la matriz.

  • El número de elementos de la colección es mayor que el espacio disponible comprendido desde el parámetro de índice hasta el final del parámetro de la matriz de destino.

El tipo de la colección se convierte automáticamente al tipo del parámetro de la matriz de destino. Sin embargo, este método solamente 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 inicia una excepción InvalidCastException.

Este método no está sincronizado.

Ejemplos

En este ejemplo de C# se rellena parte de una matriz de objetos ExtendedProperty con todo el contenido de la colección Stroke.ExtendedProperties, empezando en el elemento 1 (el segundo elemento de una matriz basada en cero) de la matriz de destino theCopies y dejando el primer elemento de la matriz de destino vacío (con un índice 0).

ExtendedProperty[] theCopies = new ExtendedProperty[e.Stroke.ExtendedProperties.Count + 1];
e.Stroke.ExtendedProperties.CopyTo(theCopies, 1);

En este ejemplo de Microsoft® Visual Basic® .NET se rellena parte de una matriz de objetos ExtendedProperty con todo el contenido de la colección Stroke.ExtendedProperties, empezando en el elemento 1 (el segundo elemento de una matriz basada en cero) de la matriz de destino theCopies y dejando el primer elemento de la matriz de destino vacío (con un índice 0).

Dim theCopies(e.Stroke.ExtendedProperties.Count) As ExtendedProperty
e.Stroke.ExtendedProperties.CopyTo(theCopies, 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

ExtendedProperties (Clase)

ExtendedProperties (Miembros)

Microsoft.Ink (Espacio de nombres)