Compartir a través de


CDaoTableDef Class

Representa la definición almacenada de una tabla base o tabla asociada.

class CDaoTableDef : public CObject

Members

Constructores públicos

Name

Descripción

CDaoTableDef::CDaoTableDef

construye un objeto de CDaoTableDef .

Métodos públicos

Name

Descripción

CDaoTableDef::Append

Agrega una nueva tabla en la base de datos.

CDaoTableDef::CanUpdate

Devuelve cero si la tabla puede actualizarse (puede modificar la definición de campos o propiedades de la tabla).

CDaoTableDef::Close

Cierra un definición abierto.

CDaoTableDef::Create

Crea una tabla que se puede agregar a la base de datos con Anexar.

CDaoTableDef::CreateField

Denominado para crear un campo de una tabla.

CDaoTableDef::CreateIndex

Denominado para crear un índice de una tabla.

CDaoTableDef::DeleteField

denominado para eliminar un campo de una tabla.

CDaoTableDef::DeleteIndex

denominado para eliminar un índice de una tabla.

CDaoTableDef::GetAttributes

Devuelve un valor que indica una o más características de un objeto de CDaoTableDef .

CDaoTableDef::GetConnect

Devuelve un valor que proporciona información sobre el origen de una tabla.

CDaoTableDef::GetDateCreated

Devuelve la fecha y hora en que la tabla base que era la base de un objeto de CDaoTableDef se creó.

CDaoTableDef::GetDateLastUpdated

Devuelve la fecha y hora de cambio realizado más reciente en el diseño de la tabla base.

CDaoTableDef::GetFieldCount

Devuelve un valor que representa el número de campos de la tabla.

CDaoTableDef::GetFieldInfo

Devuelve los tipos de información concreta sobre los campos en la tabla.

CDaoTableDef::GetIndexCount

Devuelve el número de índices de la tabla.

CDaoTableDef::GetIndexInfo

Devuelve los tipos de información concreta sobre los índices de la tabla.

CDaoTableDef::GetName

devuelve el nombre definido por el usuario de la tabla.

CDaoTableDef::GetRecordCount

Devuelve el número de registros de la tabla.

CDaoTableDef::GetSourceTableName

Devuelve un valor que especifica el nombre de la tabla asociada en la base de datos de origen.

CDaoTableDef::GetValidationRule

Devuelve un valor que valide los datos en un campo mientras se cambia o se agrega a una tabla.

CDaoTableDef::GetValidationText

Devuelve un valor que especifica el texto del mensaje que la aplicación muestra si el valor de un objeto de campo no cumple la regla de validación especificada.

CDaoTableDef::IsOpen

Devuelve cero si la tabla está abierto.

CDaoTableDef::Open

Abra un definición existente almacenado en la colección de Definición de base de datos.

CDaoTableDef::RefreshLink

Actualiza la información de conexión para una tabla asociada.

CDaoTableDef::SetAttributes

Establece un valor que indica una o más características de un objeto de CDaoTableDef .

CDaoTableDef::SetConnect

Establece un valor que proporciona información sobre el origen de una tabla.

CDaoTableDef::SetName

establece el nombre de la tabla.

CDaoTableDef::SetSourceTableName

Establece un valor que especifica el nombre de una tabla asociada en la base de datos de origen.

CDaoTableDef::SetValidationRule

Establece un valor que valide los datos en un campo mientras se cambia o se agrega a una tabla.

CDaoTableDef::SetValidationText

Establece un valor que especifica el texto del mensaje que la aplicación muestra si el valor de un objeto de campo no cumple la regla de validación especificada.

Miembros de datos públicos

Name

Descripción

CDaoTableDef::m_pDAOTableDef

Un puntero a la interfaz de DAO al objeto de definición.

CDaoTableDef::m_pDatabase

base de datos de origen para esta tabla.

Comentarios

Cada objeto de base de datos de DAO mantiene una colección, denominada TableDefs, que contiene todos los objetos guardados de definición de DAO.

Se manipula una definición de tabla utilizando un objeto de CDaoTableDef . Por ejemplo, puede:

  • Examine la estructura del campo y de índice de cualquier valor local, asociada, o la tabla externa en una base de datos.

  • Llame a las funciones miembro de SetConnect y de SetSourceTableName para las tablas asociadas, y utilice la función miembro de RefreshLink para actualizar conexiones a las tablas asociadas.

  • Llame a la función miembro de CanUpdate para determinar si puede modificar definiciones de campo de la tabla.

  • Obtiene o fije las condiciones de la validación mediante GetValidationRule y SetValidationRule, y el miembro de GetValidationText y de SetValidationText funciona.

  • Utilice la función miembro de Abrir para crear una tabla, un dynaset-, o un objeto de CDaoRecordset de tipo instantánea.

    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 DAO suelen proporcionar capacidades máximas porque son específicas del motor de base de datos Microsoft Jet.

Para utilizar objetos de definición para trabajar con una tabla existente o crear una nueva tabla

  1. En todos los casos, primero cree un objeto de CDaoTableDef , proporcionando un puntero a un objeto de CDaoDatabase al que la tabla pertenece.

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

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

    • Para crear una nueva tabla, llame a la función miembro de Crear del objeto de definición, proporcionando el nombre de la tabla. Llame a CreateField y CreateIndex para agregar campos e índices de la tabla.

    • Llame a Anexar para guardar la tabla y se anexa a la colección de TableDefs de base de datos. Crear coloca el definición en un estado abierto, por lo que después de llamar a Crear que no llama Abrir.

      Sugerencia

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

Para utilizar el objeto de definición que se ha abierto o creado, crear y abrir un objeto de CDaoRecordset , especificando el nombre de definición con un valor de dbOpenTable en el parámetro de nOpenType .

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

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

Jerarquía de herencia

CObject

CDaoTableDef

Requisitos

encabezado: afxdao.h

Vea también

Referencia

CObject (Clase)

Gráfico de jerarquías

CDaoDatabase Class

CDaoRecordset Class