Compartir a través de


Referencia de plantillas de consumidor OLE DB

Las plantillas de consumidor OLE DB contienen las siguientes clases. El material de referencia también incluye temas sobre las macros de las plantillas de consumidor OLE DB.

Clases de sesión

CDataConnection
Administra la conexión con el origen de datos. Se trata de una clase útil para crear clientes porque encapsula los objetos necesarios (origen de datos y sesión) y parte del trabajo que debe realizar al conectarse a un origen de datos.

CDataSource
Corresponde a un objeto de origen de datos OLE DB, que representa una conexión a través de un proveedor a un origen de datos. Una o varias sesiones de base de datos, cada una representada por un objeto CSession, puede tener lugar en una sola conexión.

CEnumerator
Corresponde a un objeto enumerador OLE DB, que recupera información del conjunto de filas sobre los orígenes de datos disponibles.

CEnumeratorAccessor
Lo usa CEnumerator para acceder a los datos del conjunto de filas del enumerador. Este conjunto de filas se compone de los orígenes de datos y enumeradores visibles desde el enumerador actual.

CSession
Representa una única sesión de acceso a la base de datos. Una o varias sesiones se pueden asociar a cada objeto CDataSource.

Clases de descriptores de acceso

CAccessor
Se usa para los registros que están enlazados estáticamente a un origen de datos. Use esta clase de descriptor de acceso cuando conozca la estructura del origen de datos.

CAccessorBase
Clase base para las clases del descriptor de acceso.

CDynamicAccessor
Descriptor de acceso que se puede crear en el entorno de ejecución, en función de la información de columna del conjunto de filas. Use esta clase para recuperar datos si no conoce la estructura del origen de datos.

CDynamicParameterAccessor
Descriptor de acceso que se puede usar cuando se desconocen los tipos de comandos. Obtiene la información de parámetros mediante una llamada a la interfaz ICommandWithParameters, si el proveedor admite la interfaz.

CDynamicStringAccessor
Permite acceder a un origen de datos cuando se desconoce la estructura subyacente de la base de datos.

CDynamicStringAccessorA
Similar a, CDynamicStringAccessor salvo que esta clase solicita datos a los que se accede desde el almacén de datos como datos de cadena ANSI.

CDynamicStringAccessorW
Similar a, CDynamicStringAccessor salvo que esta clase solicita datos a los que se accede desde el almacén de datos como datos de cadena UNICODE.

CManualAccessor
Descriptor de acceso con métodos para controlar tanto columnas como parámetros de comando. Con esta clase, puede usar cualquier tipo de datos siempre que el proveedor pueda convertir el tipo.

CNoAccessor
Se puede usar como argumento de plantilla cuando no desea que la clase admita parámetros ni columnas de salida.

CXMLAccessor
Similar a, CDynamicStringAccessor salvo que esta clase convierte todos los datos a los que se accede desde el almacén de datos como datos con formato XML (etiquetados).

Clases de conjunto de fila

CAccessorRowset
Encapsula un conjunto de filas y sus descriptores de acceso asociados.

CArrayRowset
Se usa para tener acceso a elementos de un conjunto de filas mediante la sintaxis de matriz.

CBulkRowset
Se usa para capturar y manipular filas de forma masiva mediante la recuperación de varios identificadores de fila con una sola llamada.

CNoRowset
Se puede usar como argumento de plantilla si el comando no devuelve un conjunto de filas.

cRestrictions
Se usa para especificar restricciones para conjuntos de filas de esquema.

CRowset
Se usa para manipular, establecer y recuperar datos de conjuntos de filas.

CStreamRowset
Devuelve un objeto ISequentialStream en lugar de un conjunto de filas; a continuación, se usa el método Read para recuperar datos en formato XML. (SQL Server 2000 aplica el formato; tenga en cuenta que esta característica solo funciona con SQL Server 2000).

IRowsetNotifyImpl
Proporciona una implementación ficticia para IRowsetNotify, con funciones vacías para los IRowsetNotify métodos OnFieldChange, OnRowChange y OnRowsetChange.

Clases de conjunto de filas de esquema y clases typedef

Las plantillas OLE DB proporcionan un conjunto de clases que corresponden a los conjuntos de filas de esquema OLE DB.

Clases de comando

CCommand
Se usa para establecer y ejecutar un comando OLE DB basado en parámetros. Para simplemente abrir un conjunto de filas sencillo, use CTable en su lugar.

CMultipleResults
Se usa como argumento de plantilla para la plantilla CCommand cuando desea que el comando controle varios conjuntos de resultados.

CNoAccessor
Se usa como argumento de plantilla para las clases de plantilla, como CCommand y CTable, que toman un argumento de clase de descriptor de acceso. Use CNoAccessor si no desea que la clase admita parámetros o columnas de salida.

CNoMultipleResults
Se usa como argumento de plantilla para la plantilla CCommand cuando desea que el comando controle un único conjunto de filas. CNoMultipleResults es el valor predeterminado para el argumento de plantilla.

CNoRowset
Se usa como argumento de plantilla para CCommand o CTable si el comando o la tabla no devuelve un conjunto de filas.

CTable
Se usa para acceder a un conjunto de filas simple sin parámetros.

Clases de propiedades

CDBPropIDSet
Se usa para pasar una matriz de identificadores de propiedad para los que el consumidor quiere información de propiedad. Las propiedades pertenecen a un conjunto de propiedades.

CDBPropSet
Se usa para establecer propiedades en un proveedor.

Clase de marcador

CBookmark
Se usa como índice para acceder a los datos de un conjunto de filas.

Clase de error

CDBErrorInfo
Se usa para recuperar la información de error de OLE DB.

Consulte también

Referencia de plantillas de proveedores OLE DB
Plantillas OLE DB