CDaoTableDefInfo (Estructura)

La estructura CDaoTableDefInfo contiene información sobre un objeto tabledef definido para objetos de acceso a datos.

Sintaxis

struct CDaoTableDefInfo
{
    CString m_strName;               // Primary
    BOOL m_bUpdatable;               // Primary
    long m_lAttributes;              // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    CString m_strSrcTableName;       // Secondary
    CString m_strConnect;            // Secondary
    CString m_strValidationRule;     // All
    CString m_strValidationText;     // All
    long m_lRecordCount;             // All
};

Parámetros

m_strName
Asigna un nombre único al objeto tabledef. Para recuperar el valor de esta propiedad directamente, llame a la función miembro GetName del objeto tabledef. Para obtener más información, consulta el tema sobre la «propiedad Nombre» de la Ayuda de DAO.

m_bUpdatable
Indica si se pueden realizar cambios en la tabla. La forma rápida de determinar si una tabla es actualizable es abrir un objeto CDaoTableDef de la tabla y llamar a la función miembro CanUpdate del objeto. CanUpdate siempre devuelve un valor distinto de cero (TRUE) con un objeto tabledef recién creado y 0 (FALSE) con un objeto tabledef adjunto. Un objeto tabledef nuevo solo se puede anexar a una base de datos en la que el usuario actual tenga permiso de escritura. Si la tabla solo contiene campos no actualizables, CanUpdate devuelve 0. Si uno o varios campos son actualizables, CanUpdate devuelve un valor distinto de cero. Solo se pueden editar los campos actualizables. Para obtener más información, consulta el tema sobre la «propiedad Actualizable» de la Ayuda de DAO.

m_lAttributes
Especifica las características de la tabla representada por el objeto tabledef. Para recuperar los atributos actuales de un objeto tabledef, llame a su función miembro GetAttributes. El valor devuelto puede ser una combinación de estas constantes largas (mediante el operador OR bit a bit |):

• dbAttachExclusive En las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que la tabla es una tabla adjunta abierta para uso exclusivo.

• dbAttachSavePWD En las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que el identificador de usuario y la contraseña de la tabla adjunta se guardan con la información de conexión.

• dbSystemObject Indica que la tabla es una tabla del sistema proporcionada por el motor de base de datos de Microsoft Jet. (Solo lectura).

• dbHiddenObject Indica que la tabla es una tabla oculta proporcionada por el motor de base de datos de Microsoft Jet (para su uso temporal). (Solo lectura).

• dbAttachedTable Indica que la tabla es una tabla adjunta de una base de datos no ODBC, como una base de datos Paradox.

• dbAttachedODBC Indica que la tabla es una tabla adjunta de una base de datos ODBC, como Microsoft SQL Server.

m_dateCreated
Fecha y hora de creación de la tabla. Para recuperar directamente la fecha en que se creó la tabla, llame a la función miembro GetDateCreated del objeto CDaoTableDef asociado a la tabla. Vea la sección Comentarios más abajo para obtener más información. Para obtener información relacionada, vea el tema "DateCreated, LastUpdated Properties" en la Ayuda de DAO.

m_dateLastUpdated
Fecha y hora del cambio más reciente realizado en el diseño de la tabla. Para recuperar directamente la fecha en que la tabla se actualizó por última vez, llame a la función miembro GetDateLastUpdated del objeto CDaoTableDef asociado a la tabla. Vea la sección Comentarios más abajo para obtener más información. Para obtener información relacionada, vea el tema "DateCreated, LastUpdated Properties" en la Ayuda de DAO.

m_strSrcTableName
Especifica el nombre de una tabla adjunta, si la hay. Para recuperar directamente el nombre de la tabla de origen, llame a la función miembro GetSourceTableName del objeto CDaoTableDef asociado a la tabla.

m_strConnect
Proporciona información sobre el origen de una base de datos abierta. Para comprobar esta propiedad, llame a la función miembro GetConnect del objeto CDaoTableDef. Para obtener más información sobre las cadenas de conexión, vea GetConnect.

m_strValidationRule
Valor que valida los datos de los campos del objeto tabledef a medida que se cambian o agregan a una tabla. La validación solo se admite en bases de datos que usan el motor de base de datos de Microsoft Jet. Para recuperar directamente la regla de validación, llame a la función miembro GetValidationRule del objeto CDaoTableDef asociado a la tabla. Para obtener información relacionada, vea el tema sobre la propiedad ValidationRule en la Ayuda de DAO.

m_strValidationText
Valor que especifica el texto del mensaje que la aplicación debe mostrar si no se cumple la regla de validación especificada por la propiedad ValidationRule. Para obtener información relacionada, vea el tema sobre la propiedad ValidationText de la Ayuda de DAO.

m_lRecordCount
Número de registros a los que se accede en un objeto tabledef. Este valor de propiedad es de solo lectura. Para recuperar directamente el número de registros, llame a la función miembro GetRecordCount del objeto CDaoTableDef. En documentación de GetRecordCount se describe el número de registros en mayor profundidad. Tenga en cuenta que recuperar este número puede ser una operación que consume mucho tiempo si la tabla contiene muchos registros.

Comentarios

Tabledef es un objeto de la clase CDaoTableDef. Las referencias a las principales y secundarias anteriores indican cómo se devuelve la información mediante la función miembro GetTableDefInfo en la clase CDaoDatabase.

La información recuperada por la función miembro CDaoDatabase::GetTableDefInfo se almacena en una estructura CDaoTableDefInfo. Llame a la función miembro GetTableDefInfo del objeto CDaoDatabase en cuya colección TableDefs se almacena el objeto tabledef. CDaoTableDefInfo también define una función miembro Dump en las compilaciones de depuración. Puede usar Dump para volcar el contenido de un objeto CDaoTableDefInfo.

La configuración de fecha y hora se deriva del equipo en el que se ha creado o actualizado por última vez la tabla base. En un entorno multiusuario, los usuarios deben obtener esta configuración directamente desde el servidor de archivos para evitar discrepancias en los valores de las propiedades DateCreated y LastUpdated.

Requisitos

Encabezado: afxdao.h

Consulte también

Estructuras, estilos, devoluciones de llamada y mapas de mensajes
CDaoTableDef (clase)
CDaoDatabase (clase)