Clase de CDaoWorkspace

Artículo
04/10/2013

Administra una sesión denominada, protegida mediante contraseña de la base de datos de inicio de sesión a cerrar la sesión, por un único usuario.

class CDaoWorkspace : public CObject

Members

Constructores públicos

Name	Descripción
CDaoWorkspace::CDaoWorkspace	Construye un objeto del área de trabajo.Después, llamada Crear o Abrir.

Métodos públicos

Name	Descripción
CDaoWorkspace::Append	Anexa un área de trabajo creada recientemente a la colección de áreas de trabajo del motor de base de datos.
CDaoWorkspace::BeginTrans	Inicia una nueva transacción, que se aplica a todas las bases de datos abierto en el área de trabajo.
CDaoWorkspace::Close	Cierre el área de trabajo y todos los objetos que contiene.Pendientes transacciones es la revierte.
CDaoWorkspace::CommitTrans	completa la transacción actual y guarda los cambios.
CDaoWorkspace::CompactDatabase	compacta (o duplicados) una base de datos.
CDaoWorkspace::Create	Crea un nuevo objeto de área de trabajo de DAO.
CDaoWorkspace::GetDatabaseCount	Devuelve el número de objetos de base de datos de DAO en la colección de bases de datos del área de trabajo.
CDaoWorkspace::GetDatabaseInfo	Devuelve información sobre una base de datos especificada de DAO definido en la colección de bases de datos del área de trabajo.
CDaoWorkspace::GetIniPath	Devuelve la ubicación de los valores de inicialización del motor de base de datos Microsoft Jet en el Registro de Windows.
CDaoWorkspace::GetIsolateODBCTrans	Devuelve un valor que indica si las varias transacciones que implican el mismo origen de datos ODBC se aíslan a través de varias conexiones forzadas al origen de datos.
CDaoWorkspace::GetLoginTimeout	Devuelve el número de segundos antes de que se produzca un error cuando el usuario intenta iniciar una sesión en una base de datos ODBC.
CDaoWorkspace::GetName	Devuelve el nombre definido por el usuario para el objeto del área de trabajo.
CDaoWorkspace::GetUserName	Devuelve el nombre de usuario especificado cuando el área de trabajo creada.Es el nombre del propietario del área de trabajo.
CDaoWorkspace::GetVersion	Devuelve una cadena que contiene la versión del motor de base de datos asociado al área de trabajo.
CDaoWorkspace::GetWorkspaceCount	Devuelve el número de objetos del área de trabajo de DAO en la colección de áreas de trabajo del motor de base de datos.
CDaoWorkspace::GetWorkspaceInfo	Devuelve información sobre un área de trabajo especificada de DAO definido en la colección de áreas de trabajo del motor de base de datos.
CDaoWorkspace::Idle	Permite que el motor de base de datos realizar tareas en segundo plano.
CDaoWorkspace::IsOpen	Devuelve cero si el área de trabajo está abierto.
CDaoWorkspace::Open	Explícitamente abre un objeto del área de trabajo asociado al área de trabajo predeterminada de DAO.
CDaoWorkspace::RepairDatabase	Intenta reparar una base de datos dañada.
CDaoWorkspace::Rollback	Finaliza la transacción actual y no guarda los cambios.
CDaoWorkspace::SetDefaultPassword	Establece la contraseña que el motor de base de datos utiliza cuando un objeto del área de trabajo se crea sin contraseña concreta.
CDaoWorkspace::SetDefaultUser	Establece el nombre de usuario que el motor de base de datos utiliza cuando un objeto del área de trabajo se crea sin un nombre de usuario.
CDaoWorkspace::SetIniPath	Establece la ubicación de los valores de inicialización del motor de base de datos Microsoft Jet en el Registro de Windows.
CDaoWorkspace::SetIsolateODBCTrans	Especifica si las varias transacciones que implican el mismo origen de datos ODBC están aisladas fuerza varias conexiones al origen de datos.
CDaoWorkspace::SetLoginTimeout	Establece el número de segundos antes de que se produzca un error cuando el usuario intenta iniciar sesión en un origen de datos ODBC.

Miembros de datos públicos

Name	Descripción
CDaoWorkspace::m_pDAOWorkspace	Señala al objeto subyacente del área de trabajo de DAO.

Comentarios

En la mayoría de los casos, no necesitará varias áreas de trabajo, y no necesitará crear objetos explícitos del área de trabajo; al abrir base de datos y los objetos de conjunto de registros, utilizan el área de trabajo predeterminada de DAO.Sin embargo, si es necesario, puede ejecutar varias sesiones al mismo tiempo crear objetos adicionales del área de trabajo.Cada objeto del área de trabajo puede contener objetos de base de datos abiertos se crean en su propia colección de bases de datos.En MFC, un área de trabajo es principalmente administrador de transacciones, especificando un conjunto de bases de datos abierto todo el mismo “espacio de la transacción.”

[!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 DAO ofrecen un prefijo “CDao”.las clases MFC basadas en DAO son generalmente más capaces que las clases MFC basadas en ODBC.Las clases DAO tienen acceso a datos a través del motor de base de datos Microsoft Jet, incluidos los controladores ODBC.También admiten operaciones (DDL) de lenguaje de definición de datos, como crear bases de datos y agregar las tablas y los campos a través de las clases, sin tener que llamar a DAO directamente.

Funciones

La clase CDaoWorkspace proporciona lo siguiente:

Acceso explícito, si es necesario, a un área de trabajo predeterminada, creada inicializar el motor de base de datos.Normalmente se utiliza el área de trabajo predeterminada de DAO implícitamente haciendo la base de datos y objetos de conjunto de registros.
Un espacio de la transacción en la que las transacciones se aplican a todas las bases de datos abierto en el área de trabajo.Puede crear áreas de trabajo adicionales para administrar espacios separados de la transacción.
Una interfaz a muchas propiedades del motor de base de datos Microsoft Jet subyacente (vea las funciones miembro static).Abriendo o creando un área de trabajo, o llamar a una función miembro estática antes de abierto o cree, inicialice el motor de base de datos.
Acceso a la colección de áreas de trabajo del motor de base de datos, que almacena todas las áreas de trabajo activos que se han anexada a.También puede crear y ejecutar las áreas de trabajo sin anexarlas a la colección.

Seguridad

MFC no implementa las colecciones de los usuarios y grupos en DAO, que se utilizan para el control de seguridad.Si necesita los aspectos de DAO, debe programarlas usted mismo a través de llamadas directas a las interfaces de DAO.Para obtener información, vea nota técnica 54.

Uso

Puede utilizar la clase CDaoWorkspace :

Explícitamente abra el área de trabajo predeterminada.

El uso del área de trabajo predeterminada suele implícitamente — cuando se abren los nuevos objetos de CDaoDatabase o de CDaoRecordset .Pero puede que necesite tener acceso explícitamente (por ejemplo, las propiedades del motor de base de datos de acceso o colección de áreas de trabajo.Vea “uso Implicit del área de trabajo predeterminada”.
Crear nuevas áreas de trabajo.Llame a Anexar si desea agregarlos a la colección de áreas de trabajo.
Abra un área de trabajo existente en la colección de áreas de trabajo.

Crear una nueva área de trabajo que no existe en la colección de áreas de trabajo se describe en función de miembro de Crear .Los objetos del área de trabajo no se mantienen en ningún modo entre las sesiones del motor de datababase.Si a uninitialize los vínculos de aplicación MFC estáticamente, finalizando la aplicación el motor de base de datos.Si se a uninitialize los vínculos de aplicación con MFC dinámicamente, el motor de base de datos cuando se descarga el archivo DLL de MFC.

Explícitamente abriendo el área de trabajo predeterminada, o un área de trabajo existente en las áreas de trabajo colección, se describe en función de miembro de Abrir .

Finalizar una sesión del área de trabajo cerrando el área de trabajo con la función miembro de Cerrar .Cerrar cierra cualquier base de datos que no ha cerrado previamente, gira revertir las transacciones sin confirmar.

Transacciones

DAO administra transacciones en el nivel de área de trabajo; por consiguiente, las transacciones en un área de trabajo con bases de datos abierto de varias se aplican a todas las bases de datos.Por ejemplo, si dos bases de datos tienen actualizaciones sin confirmar y llama a CommitTrans, todas las actualizaciones se confirman.Si desea restringir transacciones en una única base de datos, necesita un objeto independiente del área de trabajo para él.

Uso implícito del área de trabajo predeterminada

MFC utiliza el área de trabajo predeterminada de DAO implícitamente en las circunstancias siguientes:

Si crea un nuevo objeto de CDaoDatabase pero no lo hace a través de un objeto existente de CDaoWorkspace , MFC crea un objeto temporal del área de trabajo para usted, que corresponde DAO a predeterminado el área de trabajo.Si lo hace para varias bases de datos, todos los objetos de base de datos se asociado al área de trabajo predeterminada.Puede tener acceso al área de trabajo de una base de datos a través de un miembro de datos de CDaoDatabase .
De igual forma, si crea un objeto de CDaoRecordset sin proporcionar un puntero a un objeto de CDaoDatabase , MFC crea un objeto de base de datos temporal y, por extensión, un objeto temporal del área de trabajo.Puede tener acceso a la base de datos de un conjunto de registros, e indirectamente al área de trabajo, a través de un miembro de datos de CDaoRecordset .