Add (Método)

           

Agrega un miembro a un objeto Collection.

Sintaxis

objeto.Add item, key, before, after

La sintaxis del método Add consta del calificador de objeto y los argumentos con nombre siguientes:

Parte	Descripción
objeto	Requerido. Una expresión de objeto que da como resultado un objeto incluido en la lista Se aplica a.
item	Requerido. Una expresión de cualquier tipo que especifica el miembro que se va a agregar a la colección.
key	Opcional. Una expresión de cadena única que especifica una cadena clave para utilizarla en lugar de un índice posicional al tener acceso a un miembro de la colección.
before	Opcional. Expresión que especifica una posición relativa en la colección. El miembro a agregar se colocará en la colección antes del miembro identificado por el argumento argumento before. Si es una expresión numérica, before debe ser un número entre 1 y el valor de la propiedad Count de la colección. Si es una expresión de cadena, before debe corresponder al argumento key especificado al agregar a la colección el miembro al que se hace referencia. Es posible especificar posiciones con before o con after, pero no con ambos.
after	Opcional. Expresión que especifica una posición relativa en la colección. El miembro que se va a agregar se colocará en la colección después del miembro identificado por el argumento after. Si es numérico, after debe ser un número entre 1 y el valor de la propiedad Count de la colección. Si es una cadena, after debe corresponder al argumento key especificado al agregar a la colección el miembro al que se hace referencia. Es posible especificar posiciones con before o con after, pero no con ambos.

Comentarios

Siempre que el argumento before o after sea una expresión de cadena o numérica, se debe referir a un miembro existente de la colección; de lo contrario ocurrirá un error.

También ocurre un error si una key especificada duplica la key de un miembro existente de la colección.