Propiedad CommandText (ADO)

Indica el texto de un comando que se va a emitir en un proveedor.

Configuración y valores devueltos

Obtiene o establece un valor de tipo String que contiene un comando de proveedor, como una instrucción SQL, un nombre de tabla, una dirección URL relativa o una llamada a procedimiento almacenado. El valor predeterminado es la cadena vacía ("").

Comentarios

Utilice la propiedad CommandText para establecer o devolver el texto de un comando representado por un objeto Command. Normalmente, esta será una instrucción SQL, pero también puede ser cualquier otro tipo de instrucción de comando reconocida por el proveedor, como una llamada a procedimiento almacenado. Una instrucción SQL debe ser de un dialecto o versión específicos, ambos admitidos por el procesador de consultas del proveedor.

Si la propiedad Prepared del objeto Command se establece en True y el objeto Command se enlaza a una conexión abierta al establecer la propiedad CommandText, ADO preparará la consulta (es decir, un formulario compilado de la consulta almacenada por el proveedor) cuando llame a los métodos Execute u Open.

Según el valor de la propiedad CommandType, ADO puede modificar la propiedad CommandText. Puede leer la propiedad CommandText en cualquier momento para ver el texto del comando que usará ADO durante la ejecución.

Utilice la propiedad CommandText para establecer o devolver una dirección URL relativa que especifique un recurso, como un archivo o directorio. El recurso es relativo a una ubicación especificada explícitamente por una dirección URL absoluta, o implícitamente por un objeto Connection abierto.

Nota

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

Se aplica a

Objeto Command (ADO)

Consulte también

Ejemplo de las propiedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size y Direction (VB)
Ejemplo de las propiedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size y Direction (VC++)
Requery (método)
Ejemplo de las propiedades ActiveConnection, CommandText, CommandTimeout, CommandType, Size y Direction (JScript)