Compartir a través de


CustomStrokes.CopyTo (Método)

Actualización: noviembre 2007

Copia todos los elementos de la colección CustomStrokes actual en la matriz unidimensional especificada, empezando en el índice de la matriz de destino especificado.

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 CustomStrokes
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 System.Array en el mismo orden en que el enumerador recorre en iteración el objeto CustomStrokes.

Se produce una excepción si:

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

  • 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 no está sincronizado.

Ejemplos

En este ejemplo de C# se rellena parte de una matriz de objetos Strokes con todo el contenido de la colección Ink.CustomStrokes, 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).

Strokes[] theCopies = new Strokes[theInkCollector.Ink.CustomStrokes.Count + 1];
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1);

En este ejemplo de Visual Basic .NET se rellena parte de una matriz de objetos Strokes con todo el contenido de la colección Ink.CustomStrokes, 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(theInkCollector.Ink.CustomStrokes.Count) As Strokes
theInkCollector.Ink.CustomStrokes.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

CustomStrokes (Clase)

CustomStrokes (Miembros)

Microsoft.Ink (Espacio de nombres)