Método Append (ADO)

Se aplica a: Access 2013, Office 2013

Anexa un objeto a una colección. Si la colección es Fields, se puede crear un nuevo objeto Field antes de anexarlo a la colección.

Sintaxis

colección. Append (objeto)

campos. Append Name, Type, DefinedSize, Attrib, FieldValue

Parámetros

Parámetro	Descripción
collection	Objeto de colección.
fields	Colección Fields.
object	Variable de objeto que representa el objeto que se va a anexar.
Name	Valor de tipo String que contiene el nombre del nuevo objeto Field. No puede ser el nombre de ningún objeto de fields.
Tipo	Valor de DataTypeEnum, cuyo valor predeterminado es adEmpty, que especifica el tipo de datos del nuevo campo. ADO no admite los siguientes tipos de datos, por lo que no deben usarse al anexar nuevos campos a un objeto Recordset: adIDispatch, adIUnknown, adVariant.
DefinedSize	Es opcional. Un valor de tipo Long que representa el tamaño definido, en caracteres o bytes, del nuevo campo. El valor predeterminado de este parámetro se deriva de Type. Campos cuyo valor de DefinedSize es mayor que 255 bytes y campos tratados como columnas de longitud variable. (No se especifica el valor predeterminado de DefinedSize.)
Attrib	Es opcional. Un valor de FieldAttributeEnum, cuyo valor predeterminado es adFldDefault, que especifica los atributos del nuevo campo. Si no se especifica este valor, el campo contendrá atributos derivados de Type.
FieldValue	Es opcional. Variant que representa el valor del nuevo campo. Si no se especifica, el campo se anexa con un valor null.

Comentarios

Parameters (colección)

Es preciso establecer el valor de la propiedad Type de un objeto Parameter antes de anexarlo a la colección Parameters. Si selecciona un tipo de datos de longitud variable, también deberá establecer la propiedad Size en un valor mayor que cero.

Describir personalmente los parámetros minimiza el número de llamadas al proveedor y, en consecuencia, mejora el rendimiento a la hora de usar procedimientos almacenados o consultas parametrizadas. Sin embargo, es preciso conocer las propiedades de los parámetros asociados a la consulta parametrizada o al procedimiento almacenado al que desee llamar.

Utilice el método CreateParameter para crear objetos Parameter con los valores de propiedad adecuados y utilice el método Append para anexarlos a la colección Parameters. Esto le permite establecer y devolver los valores de parámetro sin tener que llamar al proveedor para obtener la información de los parámetros. Si escribe a un proveedor que no proporcione información de parámetros, debe utilizar este método para rellenar manualmente la colección Parameters y poder utilizar parámetros.

Fields (colección)

El parámetro FieldValue solo es válido cuando se agrega un objeto Field a un objeto Record y no a un objeto Recordset. Con un objeto Record, se pueden anexar campos y proporcionar valores al mismo tiempo. Con un objeto Recordset, se deben crear los campos mientras está cerrado el objeto Recordset, después abrir el objeto Recordset y asignar valores a los campos.

Nota:

[!NOTA] Para los nuevos objetos Field que se han anexado a la colección Fields de un objeto Record, se debe establecer primero la propiedad Value para que se puedan especificar las demás propiedades de Field. Primero, se debe asignar un valor específico a la propiedad Value y se debe llamar a Update en la colección Fields. A continuación, se podrá obtener acceso a otras propiedades como Type o Attributes.

Los objetos Field de los siguientes tipos de datos (DataTypeEnum) no se pueden anexar a la colección Fields; si se anexan, se generará un error: adArray, adChapter, adEmpty, adPropVariant y adUserDefined. Además, ADO no admite los siguientes tipos de datos: adIDispatch, adIUnknown y adIVariant. En el caso de estos tipos, no se producirá un error cuando se anexen, pero su uso puede generar resultados imprevisibles, incluidas pérdidas de memoria.

Recordset

Si no se establece la propiedad CursorLocation antes de llamar al método Append, el valor de CursorLocation se establecerá automáticamente en adUseClient (un valor de CursorLocationEnum) cuando se llame al método Open del objeto Recordset.

Se producirá un error en tiempo de ejecución si se llama al método Append en la colección Fields de un objeto Recordset abierto o en un objeto Recordset donde se ha configurado la propiedad ActiveConnection. Sólo se pueden anexar campos a un objeto Recordset que no está abierto y aún no se ha conectado a ningún origen de datos. Este suele ser el caso cuando se crea un objeto Recordset con el método CreateRecordset o cuando se asigna a una variable de objeto.

Record

No se producirá un error en tiempo de ejecución si se llama al método Append en la colección Fields de un objeto Record abierto. El nuevo campo se agregará a la colección Fields del objeto Record. Si el objeto Record se deriva de un objeto Recordset, el nuevo campo no aparecerá en la colección Fields del objeto Recordset.

Se puede crear un campo inexistente y anexarlo a la colección Fields mediante la asignación de un valor al objeto de campo como si ya existiese en la colección. La asignación hará que se cree y se anexe automáticamente el objeto Field y, a continuación, se completa la asignación.

Después de anexar un objeto Field a la colección Fields de un objeto Record, llame al método Update de la colección Fields para guardar el cambio.