Objeto Command (ADO)
Define un comando específico que se va a ejecutar en un origen de datos.
Observaciones
Utilice un objeto Command para consultar una base de datos y devolver registros en un objeto recordset de , ejecutar una operación masiva o manipular la estructura de una base de datos. Según la funcionalidad del proveedor, algunas Command colecciones, métodos o propiedades pueden generar un error cuando se hace referencia a ellos.
Con las colecciones, métodos y propiedades de un objeto Command, puede hacer lo siguiente:
Defina el texto ejecutable del comando (por ejemplo, una instrucción SQL) con la propiedad CommandText. Como alternativa, para las estructuras de comandos o consultas que no sean cadenas simples (por ejemplo, consultas de plantilla XML), defina el comando con la propiedad CommandStream de.
Opcionalmente, indique el dialecto de comandos usado en el CommandText o CommandStream con la propiedad dialecto de.
Defina consultas con parámetros o argumentos de procedimiento almacenado con objetos Parameter y la colección Parameters Parameters.
Indique si los nombres de parámetro deben pasarse al proveedor con la propiedad namedParameters .
Ejecute un comando y devuelva un objeto Recordset si procede con el método Execute .
Especifique 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.
Establezca el número de segundos que un proveedor esperará a que se ejecute un comando con la propiedad CommandTimeout.
Asocie una conexión abierta con un objeto command estableciendo su propiedad ActiveConnection.
Establezca la propiedad Name de para identificar el objeto command de como un método en el objeto connection asociado.
Pase un objeto command de a la propiedad source de un recordset de para obtener datos.
Acceda a atributos específicos del proveedor con la colección Properties de.
Nota
Para ejecutar una consulta sin usar 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, se necesita un objeto Command cuando desee conservar el texto del comando y volver a ejecutarlo, o bien use 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 todavía crea un objeto Connection, pero no asigna ese objeto a una variable de objeto. Sin embargo, si está asociando varios objetos Command con la misma conexión, debe crear y abrir explícitamente un objeto connection ; esto asigna el objeto Connection a una variable de objeto. Asegúrese de que el objeto connection se abrió correctamente antes de asignarlo a la propiedad ActiveConnection del objeto Command de, ya que asignar un objeto Connection cerrado provoca un error. Si no establece la propiedad ActiveConnection del objeto Command de en esta variable de objeto, ADO crea un nuevo objeto Connection para cada objeto Command Command, incluso si usa la misma cadena de conexión.
Para ejecutar un Command, llámelo por su propiedad Name en el objeto connection asociado. El Command de debe tener su propiedad ActiveConnection establecida en el objeto Connection de. Si el comando de tiene parámetros, pase sus valores como argumentos al método .
Si se ejecutan dos o más objetos Command en la misma conexión y objeto Command es un procedimiento almacenado con parámetros de salida, se produce un error. Para ejecutar cada objeto 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 de. Como resultado, las dos instrucciones de código siguientes son equivalentes.
objCmd.Parameters.Item(0)
objCmd(0)
- El objeto command de no es seguro para el scripting.
Esta sección contiene el tema siguiente.
Consulte también
del objeto connection (ADO) de
colección de parámetros (ADO)
colección de propiedades de (ADO)
Apéndice A: Proveedores