COMSafeArray

Desde array 1

Sintaxis:

New COMSafeArray(<Array>, <ElementType>, <,…,>)

Parámetros:

Tipo: Array.
Un array es la fuente de datos para un COMSafeArray.

Tipo: String.
Define el tipo de elemento para un COMSafeArray.

Tipo: Number.
El número de elementos en COMSafeArray en cada dimensión, comenzando por la primera.

• <size0> da el número de elementos en la dimensión nula, primera, de COMSafeArray
• <size1> da el número de elementos en la primera dimensión, si el COMSafeArray es más de dos-dimensional;

etc. El número total de parámetros debe ser igual al número de dimensiones en el COMSafeArray.

Descripción:

Crea un COMSafeArray que contiene un tipo de elemento dado de los que están en el array.
Los valores de los elementos de COMSafeArray se seleccionan del array dado en el parámetro <ElementType>, basándose en las siguientes reglas:

• Cada valor del primer índice de un COMSafeArray define su rebanada con un número de dimensión decrementado en 1.
• Para cada valor del primer índice en un COMSafeArray, se selecciona un valor correspondiente del array, y la rebanada del COMSafeArray se inicializa con este valor. Si no hay un valor con el índice correspondiente en el array, la rebanada del COMSafeArray se inicializa con un valor de tipo Undefined.

Esto continúa hasta que la rebanada no tenga más elementos COMSafeArray.
Si la rebanada no es un elemento, y el elemento del array no es un array, se trata como un array con longitud 1.
Si se dan las dimensiones para el COMSafeArray, el COMSafeArray construido tendrá esas dimensiones. Si no se dan las dimensiones, se definen por el índice máximo del array y el nivel máximo de anidamiento del array.

Ejemplo:

Disponible desde:

Disponible desde la versión 8.0.