Colección

Superior  Previo  Próximo

Collection

 

Clase Pública

 

Esta es la clase collection principal usada por todos los elementos con la interfaz de automatización. Contiene métodos para iterar a través de la collection, para actualizar la collection y para eliminar un ítem de la collection. Es importante darse cuenta que cuando se llama a AgegarNuevo, el ítem no se agrega automáticamente a la collection actual. Los pasos típicos son: 

 

1. Llamar a AgregarNuevo para agregar un nuevo ítem 

 

2. Modificar el ítem como se desee 

 

3. Llamar a Update en el ítem para guardarlo en la base de datos 

 

4. Llamar a Refresh en la collection para incluirla en el conjunto actual 

 

La eliminación es bastante parecida -hasta que se llama a Refresh, la collection contendrá aún una referencia al item eliminado- la cual no se debería llamar. 

 

Para cada uno - puede usarse para iterar a través de la collection para lenguajes que soportan este tipo de construcciones. 

 

Atributos de Collection

 

Atributo

Tipo

Notas

Count

short

Solo lectura. El número de objetos referenciados por esta lista.

ObjectType

ObjectType

Solo lectura. Distingue los objetos de la interfaz de Despacho.

 

 

Métodos  de Collection

 

Método

Tipo

Notas 

GetAt (short)

Object

parámetro: índice [ short - in ]

 

Recupera el objeto arreglo usando un índice numérico; si el índice está fuera de los límites, se producirá un error.

Delete (short)

void

parámetro: índice [ short - in ]

 

Elimina el ítem en la referencia seleccionada

DeleteAt (Boolean, short)

void

parámetro: refresh [ Boolean - in ]

parámetro: índice [ short - in ]

 

Elimina el ítem en el índice seleccionado. También provee una opción para actualizar la collection después de la eliminación. No debería refrescar una collection mientras está recorriéndola, porque se pueden alterar el contador y las posiciones de los ítems. No debería acceder al ítem en el índice seleccionado una vez que se eliminó porque se disparará una excepción.

GetLastError ()

String

Devuelve una cadena de caracteres describiendo el error más reciente que ocurrió en relación a este objeto.

Esta función se usa raramente debido a que disparará una excepción cuando se produzca un error. 

GetByName (String)

Object

parámetro: Nombre [ String- in ]

 

Obtiene un ítem en la collection actual por un Nombre. Sólo se aplica a las siguientes colecciones: Modelos, Paquetes, Elementos, Diagramas y Valores Etiquetados.

Refresh ()

void

Refresque la collection al consultar nuevamente el modelo y cargar de nuevo la collection. Se debería llamar después de agregar un nuevo ítem o después de eliminar un ítem

AddNew (String, String)

Object

parámetro: Tipo [ String - in ]

parámetro: Nombre [ String - in ]

 

Agrega un nuevo ítem a la collection actual. Tenga en cuenta que la interfaz es la misma para todas las colecciones -debe proveer un Nombre y un tipo de Argumento-. Para qué se usan?depende del miembro de la collection actual. Tenga en cuenta también que debe llamar a Update() en el objeto de respuesta para completar a AddNew. Si no se llama a Update() el objeto se deja en un estado intermedio.