Compartir a través de

Objeto Command (ADO)

  • Artículo

Se aplica a: Access 2013, Office 2013

Define un comando específico que se intenta ejecutar con respecto a un origen de datos.

Comentarios

Use un objeto Command para realizar una consulta en una base de datos y devolver registros en un objeto Recordset, para ejecutar una operación masiva, o para manipular la estructura de una base de datos. Según la funcionalidad del proveedor, algunos métodos, colecciones o propiedades del objeto Command pueden generar un error cuando se hace referencia a ellos.

Con las colecciones, los métodos y las propiedades de un objeto Command, se puede hacer lo siguiente:

  • Definir el texto ejecutable del comando (por ejemplo, una instrucción SQL) con la propiedad CommandText.

  • Definir consultas con parámetros o argumentos de procedimientos almacenados con objetos Parameter y la colección Parameters.

  • Ejecutar un comando y devolver un objeto Recordset, si procede, con el método Execute.

  • Especificar el tipo de comando con la propiedad CommandType antes de la ejecución para optimizar el rendimiento.

  • Controlar si el proveedor guarda una versión preparada (o compilada) del comando antes de la ejecución con la propiedad Prepared.

  • Establecer el número de segundos que esperará un proveedor para la ejecución de un comando con la propiedad CommandTimeout.

  • Asociar una conexión abierta con un objeto Command estableciendo su propiedad ActiveConnection.

  • Establecer la propiedad Name para identificar el objeto Command como un método en el objeto Connection asociado.

  • Pasar un objeto Command a la propiedad Source de un objeto Recordset para obtener datos.

  • Obtener acceso a atributos específicos del proveedor con la colección Properties.

Nota:

[!NOTA] Para ejecutar una consulta sin usar un objeto Command, pase una cadena de consulta al método Execute de un objeto Connection o al método Open de un objeto Recordset. Sin embargo, un objeto Command es necesario cuando quiere conservar el texto del comando y volver a ejecutarlo o usar parámetros de consulta.

Para crear un objeto Command independientemente de un objeto Connection definido anteriormente, establezca su propiedad ActiveConnection en una cadena de conexión válida. ADO seguirá creando un objeto Connection, pero no asignará ese objeto a una variable de objeto. Sin embargo, si asocia varios objetos Command a la misma conexión, debe crear y abrir explícitamente un objeto Connection; de este modo, se asigna el objeto Connection a una variable de objeto. Si no establece la propiedad ActiveConnection del objeto Command en esta variable de objeto, ADO creará un nuevo objeto Connection para cada objeto Command, aunque se utilice la misma cadena de conexión.

Para ejecutar un objeto Command, basta con invocarlo mediante su propiedad Name en el objeto Connection asociado. El objeto Command debe tener su propiedad ActiveConnection establecida en el objeto Connection. Si el objeto Command tiene parámetros, pase como argumentos sus correspondientes valores al método.

Si se ejecutan dos o más objetos Command en la misma conexión y cualquiera de los objetos Command es un procedimiento almacenado con parámetros de salida, se producirá un error. Para ejecutar cada uno de los objetos Command, use conexiones independientes o desconecte todos los demás objetos Command de la conexión.

La colección Parameters es el miembro predeterminado del objeto Command. Como consecuencia, las dos instrucciones de código siguientes son equivalentes.