Share via

Append (método) (ADO)

  • Artículo

Agrega 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

  
collection.Append object  
fields.Append Name, Type, DefinedSize, Attrib, FieldValue

Parámetros

collection
Objeto de colección.

fields
Colección Fields.

object
Variable de objeto que representa el objeto que se va a anexar.

Nombre
Valor String que contiene el nombre del nuevo objeto Field y no debe ser el mismo que cualquier otro objeto en Fields.

Tipo
Valor DataTypeEnum, cuyo valor predeterminado es adEmpty, que especifica el tipo de datos del nuevo campo. ADO no admite los siguientes tipos de datos y no se debe usar al anexar nuevos campos a un objeto Recordset (ADO):adIDispatch, adIUnknown, adVariant.

DefinedSize
Opcional. Valor 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. Los campos que tienen un DefinedSize mayor que 255 bytes se tratan como columnas de longitud variable. El valor predeterminado de DefinedSize no está especificado.

Attrib
Opcional. Valor FieldAttributeEnum, cuyo valor predeterminado es adFldDefault, que especifica los atributos para el nuevo campo. Si no se especifica este valor, el campo contendrá atributos derivados de Type.

FieldValue
Opcional. Variant que representa el valor del nuevo campo. Si no se especifica, el campo se anexa con un valor NULL.

Comentarios

Colección Parameters

Debe establecer 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 debe establecer la propiedad Size en un valor mayor que cero.

La descripción de los parámetros por sí mismo minimiza las llamadas al proveedor y, por tanto, mejora el rendimiento cuando se usan procedimientos almacenados o consultas con parámetros. Sin embargo, debe conocer las propiedades de los parámetros asociados con el procedimiento almacenado o la consulta con parámetros a las que desea llamar.

Use el método CreateParameter para crear objetos Parameter con la configuración de propiedad adecuada y use el método Append para agregarlos a la colección Parameters. Esto le permite establecer y devolver valores de parámetro sin tener que llamar al proveedor para obtener la información de parámetros. Si está escribiendo en un proveedor que no proporciona información de parámetros, debe usar este método para rellenar manualmente la colección Parameters para no usar parámetros en absoluto.

Colección Fields

El parámetro FieldValue solo es válido al agregar un objeto Field a un objeto Record, no a un objeto Recordset. Con un objeto Record, puede anexar campos y proporcionar valores al mismo tiempo. Con un objeto Recordset debe crear campos mientras el objeto Recordset está cerrado y, a continuación, abrir el objeto Recordset y asignar valores a los campos.

Nota

Para los nuevos objetos Field que se han anexado a la colección Fields de un objeto Record, se debe establecer la propiedad Value antes de que se puedan especificar otras propiedades Field. En primer lugar, se debe haber asignado un valor específico para las propiedades Value y Update en la colección Fields a la que se llama. A continuación, se puede tener 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 y provocarán un error: adArray, adChapter, adEmpty, adPropVariant y adUserDefined. Además, ADO no admite los siguientes tipos de datos: adIDispatch, adIUnknown y adIVariant. Para estos tipos, no se producirá ningún error cuando se anexe, pero el uso puede producir resultados imprevisibles, incluidas las pérdidas de memoria.

Recordset

Si no establece la propiedad CursorLocation antes de llamar al método Append, CursorLocation se establecerá en adUseClient (un valor CursorLocationEnum ) automáticamente 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 establecido la propiedad ActiveConnection. Solo puede anexar campos a un objeto Recordset que no está abierto y que aún no se ha conectado a un origen de datos. Normalmente, este es el caso cuando un objeto Recordset se crea con el método CreateRecordset o se asigna a una variable de objeto.

Registro

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

Se puede crear y anexar un campo inexistente a la colección Fields asignando un valor al objeto de campo como si ya existiera en la colección. La asignación desencadenará la creación y anexión automáticas del objeto Field y, a continuación, se completará la asignación.

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

Se aplica a

Consulte también

Anexar y ejemplo de los métodos CreateParameter (VB)
Anexar y ejemplo de los métodos CreateParameter (VC++)
Método CreateParameter (ADO)
El método Delete (colección Fields de ADO)
Método Delete (colección de parámetros de ADO)
Delete (método) (conjunto de registros ADO)
Update (método)