CursorButtons.CopyTo (Método)
Actualización: noviembre 2007
Copia todos los elementos de la colección CursorButtons 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 CursorButtons
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 CursorButtons.
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 Object. Al intentar realizar la copia en otro tipo de matriz, se inicia una excepción InvalidCastException.
Este método está sincronizado.
Ejemplos
En este ejemplo de C# se rellena parte de una matriz de objetos CursorButton con todo el contenido de la colección Cursor.Buttons, 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).
CursorButton[] theCopies = new CursorButton[theCursor.Buttons.Count + 1];
theCursor.Buttons.CopyTo(theCopies, 1);
En este ejemplo de Visual Basic .NET se rellena parte de una matriz de objetos CursorButton con todo el contenido de la colección Cursor.Buttons, 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(theCursor.Buttons.Count) As CursorButton
theCursor.Buttons.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