Estructura CDaoQueryDefInfo

La estructura de CDaoQueryDefInfo tiene el siguiente formulario:

struct CDaoQueryDefInfo
{
 nbsp; CString m_str&Name;               / / Primario
   m_nType corto;                   / / Primario
   COleDateTime m_dateCreated;      / / Secundario
   COleDateTime m_dateLastUpdated;  / / Secundario
   BOOL m_bUpdatable;               / / Secundario
   BOOL m_bReturnsRecords;          / / Secundario
   CString m_strSQL;                / / Todos
   CString m_strConnect;            / / Todos
   m_nODBCTimeout corto;            / / Todos
}

La estructura de CDaoQueryDefInfo contiene información acerca de un objeto querydef definido para data access objects (DAO). La definición de consulta es un objeto de clase CDaoQueryDef. Las referencias a la primaria, secundaria y todos por encima de indican cómo la información es devuelto por la función de miembro de GetQueryDefInfo en clase CDaoDatabase.

Miembros

m_strName

Designa inequívocamente el objeto querydef. Para obtener más información, vea el tema "Propiedad Name" en la ayuda de DAO. Llame a CDaoQueryDef::GetName para recuperar esta propiedad directamente.

m_nType

Un valor que indica el tipo de funcionamiento de un objeto querydef. El valor puede ser uno de los siguientes:

dbQSelect Seleccione — la consulta selecciona los registros.
dbQActio&nnbsp; Acción: la consulta se mueve o cambia los datos pero no devuelven registros.
dbQCrosstab Tabla de referencias cruzadas, la consulta devuelve datos en un formato de hoja de cálculo como.
dbQDelete Eliminar: elimina de la consulta de un conjunto de filas especificadas.
dbQUpdate Actualización: la consulta cambia un conjunto de registros.
dbQAppe&ndnbsp; Anexar — la consulta agrega nuevos registros al final de una tabla o consulta.
dbQMakeTable Creación de tabla, la consulta crea una nueva tabla de un conjunto de registros.
dbQDDL Definición de datos — la consulta afecta la estructura de las tablas o sus partes.
dbQSQLPassThrough Paso: la instrucción SQL se pasa directamente a la base de datos back-end, sin procesamiento intermedio.
dbQSetOperatio&nnbsp; Unión: la consulta crea un objeto recordset de tipo instantánea que contiene datos de registros todo especificados en dos o más tablas con registros duplicados eliminados. Para incluir los duplicados, agregue la palabra clave todos en la instrucción SQL de la definición de consulta.
dbQSPTBulk Con dbQSQLPassThrough se utiliza para especificar una consulta que no devuelva los registros.
&Notanbsp; Para crear una consulta de paso a través de SQL, no se define la constante de dbQSQLPassThrough . Esto se configura automáticamente por el motor de base de datos de Microsoft Jet cuando se crea un objeto querydef y establecer la propiedad Connect.
Para obtener más información, vea el tema "Propiedad de tipo" en la ayuda de DAO.

m_dateCreated

La fecha y hora que se creó el objeto querydef. Para recuperar directamente la fecha que fue creada la definición de consulta, llame a la función miembro GetDateCreated del objeto CDaoTableDef asociado a la tabla. Ver comentarios a continuación para obtener más información. También consulte el tema "DateCreated, LastUpdated propiedades" en la ayuda de DAO.

m_dateLastUpdated

La fecha y la hora del cambio más reciente hizo la definición de consulta. Para recuperar directamente la fecha de que la última actualización de la tabla, llame a la función miembro GetDateLastUpdated de la definición de consulta. Ver comentarios a continuación para obtener más información. Y vea el tema "DateCreated, LastUpdated propiedades" en la ayuda de DAO.

m_bUpdatable

Indica si se pueden realizar cambios a un objeto querydef. Si esta propiedad es TRUE, el objeto querydef es actualizable; de lo contrario, no lo es. Updatable significa que se puede cambiar la definición de la consulta del objeto querydef. La propiedad actualizable de un objeto querydef se establece en TRUE si se puede actualizar la definición de consulta, incluso si el conjunto de registros resultante no es actualizable. Para recuperar esta propiedad directamente, llamada función de miembro de CanUpdate la definición de consulta. Para obtener más información, vea el tema "Propiedad actualizable" en la ayuda de DAO.

m_bReturnsRecords

Indica si una consulta de paso a través de SQL a una base de datos externa devuelve registros. Si esta propiedad es TRUE, la consulta devuelve registros. Para recuperar directamente esta propiedad, llame a CDaoQueryDef::GetReturnsRecords. No todos consultas de paso a través de SQL para bases de datos externas devuelven registros. Por ejemplo, una instrucción SQL UPDATE actualiza los registros sin devolver registros, mientras que una instrucción SQL, Seleccione devuelven registros. Para obtener más información, vea el tema "Propiedad ReturnsRecords" en la ayuda de DAO.

m_strSQL

La instrucción SQL que define la consulta ejecutada por un objeto querydef. La propiedad SQL contiene la instrucción SQL que determina cómo los registros se seleccionan, agrupada y ordenada al ejecutar la consulta. Puede utilizar la consulta para seleccionar registros incluir en un objeto recordset de tipo dynaset o snapshot. También puede definir consultas de grueso para modificar los datos sin devolver registros. Puede recuperar el valor de esta propiedad directamente mediante una llamada a la función de miembro GetSQL de la definición de consulta. Para obtener más información, consulte el artículo Consultas DAO en la Guía del programador de Visual C++ y el tema "Propiedad de SQL" en la ayuda de DAO.

m_strConnect

Proporciona información sobre el origen de una base de datos utilizada en una consulta de paso a través. Esta información toma la forma de una cadena de conexión. Para obtener más información acerca de connect cadenas y para obtener información acerca de recuperar directamente el valor de esta propiedad, vea la función de miembro de CDaoDatabase::GetConnect.

m_nODBCTimeout

El número de segundos que esperará el motor de base de datos de Microsoft Jet antes de un error de tiempo de espera se produce cuando se ejecuta una consulta en una base de datos ODBC. Cuando utilizas una base de datos ODBC, como Microsoft SQL Server, puede haber demoras debido a la utilización de tráfico o pesados de red del servidor ODBC. En lugar de esperar indefinidamente, puede especificar cuánto tiempo debe esperar el motor Microsoft Jet antes de que produce un error. El valor de tiempo de espera predeterminado es de 60 segundos. Puede recuperar el valor de esta propiedad directamente mediante una llamada a la función de miembro GetODBCTimeout de la definición de consulta. Para obtener más información, vea el tema "Propiedad ODBCTimeout" en la ayuda de DAO.

Comentarios

Información recuperada por la función de miembro de CDaoDatabase::GetQueryDefInfo se almacena en una estructura CDaoQueryDefInfo . Llame a GetQueryDefInfo para el objeto de base de datos en cuya colección QueryDefs se almacena el objeto querydef. CDaoQueryDefInfo también define una función miembro de volcar en versiones de depuración. Puede utilizar volcado para volcar el contenido de un objeto CDaoQueryDefInfo . Clase CDaoDatabase también proporciona funciones miembro para acceder directamente a todas las propiedades que se devuelve en un objeto de CDaoQueryDefInfo , por lo que probablemente rara vez necesitará llamar a GetQueryDefInfo.

Al agregar un nuevo campo o un objeto de parámetro a la colección de campos o parámetros de un objeto querydef, se produce una excepción si la base de datos subyacente no admite el tipo de datos especificado para el objeto nuevo.

La configuración de fecha y hora se deriva de la computadora en que se creó o se actualizó por última vez la definición de consulta. En un entorno multiusuario, los usuarios deben obtener estas propiedades configuración directamente desde el servidor de archivos utilizando el comando net time para evitar discrepancias en la DateCreated y LastUpdated. Para obtener información sobre el uso de esta y otras estructuras de información de DAO de MFC, vea el artículo colecciones DAO: obtener información acerca de objetos DAO en la Guía del programador de Visual C++.

Vea tambié&nnbsp;CDaoQueryDef, CDaoDatabase

Index