Compartir a través de


CDaoQueryDef Class

Representa una definición de consulta, o “tabla,” normalmente guarda una en una base de datos.

class CDaoQueryDef : public CObject

Members

Constructores públicos

Name

Descripción

CDaoQueryDef::CDaoQueryDef

construye un objeto de CDaoQueryDef . La siguiente llamada Abrir o Crear, según las necesidades.

Métodos públicos

Name

Descripción

CDaoQueryDef::Append

Anexa la tabla a la colección de QueryDefs de base de datos como una consulta guardada.

CDaoQueryDef::CanUpdate

Devuelve cero si la consulta puede actualizar la base de datos.

CDaoQueryDef::Close

Cierre el objeto de tabla. Destruya el objeto C++ cuando acaba con él.

CDaoQueryDef::Create

Crea el objeto subyacente de tabla de DAO. Utilice la tabla como una consulta temporal, o llamada Anexar guardarla en la base de datos.

CDaoQueryDef::Execute

Ejecuta la consulta definido por el objeto de tabla.

CDaoQueryDef::GetConnect

Devuelve la cadena de conexión asociado a la tabla. la cadena de conexión identifica el origen de datos. (Para las consultas de paso a través de SQL sólo; si no una cadena vacía).

CDaoQueryDef::GetDateCreated

Devuelve la fecha que la consulta guardada se creó.

CDaoQueryDef::GetDateLastUpdated

Devuelve la fecha que la consulta guardada se actualizó por última vez.

CDaoQueryDef::GetFieldCount

Devuelve el número de campos definidos por la tabla.

CDaoQueryDef::GetFieldInfo

Devuelve información sobre un campo específico definido en la consulta.

CDaoQueryDef::GetName

Devuelve el nombre de tabla.

CDaoQueryDef::GetODBCTimeout

Devuelve el valor de tiempo de espera utilizado por ODBC (para una consulta de ODBC) cuando se ejecuta el tabla. Esto determina cuánto tiempo permitir a la acción de la consulta completa.

CDaoQueryDef::GetParameterCount

devuelve el número de parámetros definido para la consulta.

CDaoQueryDef::GetParameterInfo

Devuelve información sobre un parámetro especificado a la consulta.

CDaoQueryDef::GetParamValue

devuelve el valor de un parámetro especificado a la consulta.

CDaoQueryDef::GetRecordsAffected

Devuelve el número de registros afectados por una consulta de acciones.

CDaoQueryDef::GetReturnsRecords

Devuelve cero si la consulta definido por la tabla devuelve los registros.

CDaoQueryDef::GetSQL

Devuelve la cadena SQL que especifica la consulta definido por la tabla.

CDaoQueryDef::GetType

Devuelve el tipo: cancelación, actualización, anexa, crear-tabla, etc.

CDaoQueryDef::IsOpen

Devuelve cero si la tabla está abierto y puede ejecutarse.

CDaoQueryDef::Open

Abra una tabla existente almacenado en la colección de QueryDefs de base de datos.

CDaoQueryDef::SetConnect

establece la cadena de conexión para una consulta de paso a través de SQL en un origen de datos ODBC.

CDaoQueryDef::SetName

Establece el nombre de la consulta guardada, reemplace el nombre en uso cuando la tabla se creó.

CDaoQueryDef::SetODBCTimeout

Establece el valor de tiempo de espera utilizado por ODBC (para una consulta de ODBC) cuando se ejecuta el tabla.

CDaoQueryDef::SetParamValue

establece el valor de un parámetro especificado a la consulta.

CDaoQueryDef::SetReturnsRecords

Especifica si la tabla devuelve los registros. Establecer este atributo a TRUE sólo es válido para las consultas de paso a través de SQL.

CDaoQueryDef::SetSQL

Establece la cadena de SQL que especifica la consulta definido por la tabla.

Miembros de datos públicos

Name

Descripción

CDaoQueryDef::m_pDAOQueryDef

Un puntero a la interfaz OLE para el objeto subyacente de tabla de DAO.

CDaoQueryDef::m_pDatabase

Un puntero al objeto de CDaoDatabase con el que la tabla es asociado. La tabla se puede guardar en la base de datos o no.

Comentarios

Un tabla es un objeto de acceso a datos que contiene la instrucción SQL que describe una consulta, y sus propiedades, como “fecha de creación” y “tiempo de espera de ODBC”. También puede crear objetos temporales de tabla sin guardarlos, pero es conveniente — y mucho más eficaz — guardar consultas normalmente reusadas en una base de datos. Un objeto de CDaoDatabase mantiene una colección, denominada la colección de QueryDefs, que contiene los querydefs guardados.

Nota

Las clases de base de datos de DAO son distintas de las clases de base de datos MFC basadas en ODBC.Todos los nombres de clase de base de datos de DAO tienen el prefijo “CDao”.Todavía puede tener acceso a orígenes de datos ODBC con las clases DAO.las clases MFC basadas en DAO son generalmente más capaces que las clases MFC basadas en ODBC; las clases DAO pueden tener acceso a los datos, incluidos mediante controladores ODBC, a través de su propio motor de base de datos.Las operaciones admiten DAO de lenguaje de definición de datos de (DDL) las clases también, como tablas de suma mediante las clases, sin tener que llamar a DAO directamente.

Uso

Objetos de tabla de uso para trabajar con una consulta guardada existente o crear una nueva consulta guardada o consulta temporal:

  1. En todos los casos, primero cree un objeto de CDaoQueryDef , proporcionando un puntero al objeto de CDaoDatabase al que la consulta pertenece.

  2. Haga lo siguiente, en función de lo que desea:

    • Para utilizar un existente guardó consulta, llame a la función miembro de Abrir del objeto de tabla, proporcionando el nombre de la consulta guardada.

    • Para crear una nueva consulta guardada, llame a la función miembro de Crear del objeto de tabla, proporcionando el nombre de la consulta. Llamar a continuación a Anexar para guardar la consulta y se anexa a la colección de QueryDefs de base de datos. Crear coloca el tabla en un estado abierto, por lo que después de llamar a Crear que no llama Abrir.

    • Para crear una tabla temporal, llame a Crear. pase una cadena vacía para el nombre de la consulta. No llame a Anexar.

Cuando termine de usar un objeto de tabla, llame a su función miembro de Cerrar ; a continuación destruya el objeto de tabla.

Sugerencia

La manera más fácil de crear consultas guardadas es crearlas y almacenar en la base de datos mediante Microsoft Access.Puede abrir y utilizarlos en el código de MFC.

propósitos

Puede utilizar un objeto de tabla para realizar cualquiera de propósitos:

  • para crear un objeto de CDaoRecordset

  • Para llamar a la función miembro de Ejecutar de objeto para ejecutar directamente una consulta de acciones o una consulta de paso a través de SQL

Puede utilizar un objeto de tabla para cualquier tipo de consulta, incluidos seleccione, acciones, referencia cruzada, eliminar, actualizar, anexarlo, crear-tabla, definición de datos, paso a través de SQL, join, y consultas masivas. El contenido de la instrucción SQL determina el tipo de consulta especificados. Para obtener información sobre los tipos de consulta, vea Ejecutar y el miembro de GetType funciona. Los conjuntos de registros se utilizan para las consultas que ha modificado la fila cambian, normalmente las utilizando SELECT… Palabras clave FROM. Ejecutar es el más utilizadas para las operaciones masivas. Para obtener más información, vea Ejecutar y CDaoRecordset.

Querydefs y conjuntos de registros

Para utilizar un objeto de tabla para crear un objeto de CDaoRecordset , crea o abre normalmente un tabla anteriormente descrita. Después crear un objeto de conjunto de registros, pasar un puntero al objeto de tabla cuando se llama a CDaoRecordset:: Abrir. La tabla que pasa debe estar en un estado abierto. Para obtener más información, vea la clase CDaoRecordset.

No puede usar una tabla para crear un conjunto de registros (el uso más común para un tabla) a menos que esté en un estado abierto. Coloque el tabla en un estado abierto llamando a Abrir o Crear.

bases de datos externas

Los objetos de Tabla son la manera preferida de utilizar el dialecto SQL nativo de un motor de base de datos externo. Por ejemplo, puede crear una consulta SQL de Transact (como se utiliza en Microsoft SQL Server) y almacenarla en un objeto de tabla. Cuando necesite utilizar una consulta SQL no basada en el motor de base de datos Microsoft Jet, debe proporcionar una cadena de conexión que apunte al origen de datos externo. Las consultas con las cadenas de conexión válidas omiten el motor de base de datos y pasar la consulta directamente en el servidor de bases de datos externo para procesar.

Sugerencia

La mejor forma de trabajar con tablas de ODBC es adjuntarlas a una base de datos de Microsoft Jet (.MDB).

Para obtener información relacionada, vea los temas “objeto de Tabla”, “colección de QueryDefs”, y “objeto de CdbDatabase” en el SDK de DAO.

Jerarquía de herencia

CObject

CDaoQueryDef

Requisitos

encabezado: afxdao.h

Vea también

Referencia

CObject (Clase)

Gráfico de jerarquías

CDaoRecordset Class

CDaoDatabase Class

CDaoTableDef Class

CDaoException Class