Método Add (VBA)

Agrega un miembro a un objeto Collection .

Sintaxis

objeto . Agregarelemento, clave, antes, después

La sintaxis del método Add contiene el cualificador de objeto y los argumentos con nombre siguientes:

Part Descripción
object Obligatorio. Expresión de objeto que se evalúa como un objeto en la lista Se aplica a .
elemento Obligatorio. Una expresión de cualquier tipo que especifica el miembro que se debe agregar a la colección.
key Opcional. Una expresión de cadena exclusiva que especifica una cadena clave que se puede usar, en lugar de un índice posicional, para obtener acceso a un miembro de la colección.
antes Opcional. Una expresión que especifica una posición relativa en la colección. El miembro que se va a agregar se coloca en la colección antes que el miembro identificado por el argumentobefore. Si es una expresión numérica, antes debe ser un número de 1 al valor de la propiedad Count de la colección. En expresiones de cadena, before debe corresponder a la clave que se especificó al agregar a la colección el miembro al que se hace referencia. Puede especificar una posición before o after, pero no ambas.
después de Opcional. Una expresión que especifica una posición relativa en la colección. El miembro que se desea agregar se sitúa en la colección detrás del miembro que identifica el argumento after. En expresiones numéricas, after debe ser un número comprendido entre 1 y el valor de la propiedad Count de la colección. En expresiones de cadena, after debe corresponder a la clave que se especificó al agregar a la colección el miembro al que se hace referencia. Puede especificar una posición before o after, pero no ambas.

Comentarios

Independientemente de si los argumentos before o after se corresponden con expresiones numéricas o de cadena, deben hacer referencia a un miembro existente de la colección. De lo contrario, se producirá un error.

Del mismo modo, se producirá un error si una clave especificada duplica la clave de un miembro existente de la colección.

Ejemplo

En este ejemplo se usa el método Add para agregar cadenas a una colección con y sin una clave. El método Item se usa implícitamente para recuperar cada cadena.

Dim c As Collection
Set c = New Collection

c.Add "a"
c.Add "c", "CC"
c.Add "b", "BB", 2
c.Add "d"

Debug.Print c(1) ' --> prints "a"
Debug.Print c(2) ' --> prints "b"
Debug.Print c(3) ' --> prints "c"

Debug.Print c("BB") ' --> prints "b"
Debug.Print c("d") ' --> error (no key was specified for this element - a positional index must be used)

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.

  • Last updated on