Método Append (ADO)
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
collection.Append object
fields.Append Name, Type, DefinedSize, Attrib, FieldValue
Parámetros
de colección de
Objeto de colección.
campos
Colección Fields.
de objeto
Variable de objeto que representa el objeto que se va a anexar.
nombre de
Valor de string que contiene el nombre del nuevo objeto Field y no debe ser el mismo nombre que ningún otro objeto de campos.
tipo de
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 y no se debe usar al anexar nuevos campos a un objeto Recordset de (ADO): adIDispatch, adIUnknown, adVariant.
DefinedSize
Opcional. Valor de 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 mayores de 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. Un Variant que representa el valor del nuevo campo. Si no se especifica, el campo se anexa con un valor NULL.
Observaciones
Colección Parameters
Debe establecer la propiedad type de un objeto Parameter antes de anexarlo a la colección Parameters de. 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 al procedimiento almacenado o a la consulta parametrizada a la 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 del parámetro. 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 parameters con el fin de 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 de, no a un objeto recordset . Con un objeto Record, puede anexar campos y proporcionar valores al mismo tiempo. Con un objeto recordset de , debe crear campos mientras se cierra el Recordset y, a continuación, abrir el recordset de y asignar valores a los campos.
Nota
Para los nuevos objetos Field que se han anexado a la colección Fields de de un objeto Record de, se debe establecer la propiedad Value antes de que se puedan especificar otras propiedades Field. En primer lugar, se debe asignar un valor específico para la propiedad Value de y Update en la colección Fields llamada. A continuación, se puede tener acceso a otras propiedades como Type o atributos de. objetos Field de los siguientes tipos de datos (DataTypeEnum) no se pueden anexar a la colección Fields y provocará un error: adArray, adChapter, adEmpty, adPropVarianty adUserDefined. Además, ADO no admite los siguientes tipos de datos: adIDispatch, adIUnknowny adIVariant. Para estos tipos, no se producirá ningún error cuando se anexa, pero el uso puede producir resultados imprevisibles, incluidas las pérdidas de memoria.
Conjunto de registros
Si no establece la propiedad cursorLocation antes de llamar al método Append de, cursorLocation se establecerá en adUseClient (un cursorLocationEnum valor) cuando se llame automáticamente 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 Recordset donde se ha establecido la propiedad activeConnection de. Solo puede anexar campos a un conjunto de registros de que no está abierto y que aún no se ha conectado a un origen de datos. Este suele ser el caso cuando un objeto recordset de se fabrica con el método CreateRecordset o se asigna a una variable de objeto.
Grabar
No se producirá un error en tiempo de ejecución si se llama al método Append en la colección Fields de un Record abierto de. El nuevo campo se agregará a la colección Fields del objeto record de. Si el record de se deriva de un recordset de, 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 field como si ya existiera en la colección. La asignación desencadenará la creación automática y la anexión del objeto Field y, a continuación, se completará la asignación.
Después de anexar un Field de a la colección Fields de de un objeto Record de, llame al método Update de la colección Fields de para guardar el cambio.
Se aplica a
Consulte también
Ejemplo de métodos Append y CreateParameter (VB )
Ejemplo de métodos Append y CreateParameter (VC++)
método CreateParameter (ADO)
método Delete de (colección de campos de ADO)
método Delete de (colección de parámetros de ADO)
método Delete de (conjunto de registros de ADO)
del método Update de