Referência dos modelos de consumidor de banco de dados OLE

Os modelos de consumidor OLE DB contêm as classes a seguir. O material de referência também inclui tópicos sobre as macros para modelos de consumidor OLE DB.

Classes de sessão

CDataConnection
Gerencia a conexão com a fonte de dados. Essa é uma classe útil para criar clientes porque encapsula objetos necessários (fonte de dados e sessão) e parte do trabalho que você precisa fazer ao se conectar a uma fonte de dados.

CDataSource
Corresponde a um objeto de fonte de dados OLE DB, representando uma conexão por meio de um provedor com uma fonte de dados. Uma ou mais sessões de banco de dados, cada uma representada por um objeto CSession, podem ocorrer em uma conexão individual.

CEnumerator
Corresponde a um objeto enumerador OLE DB, que recupera informações de conjunto de linhas sobre fontes de dados disponíveis.

CEnumeratorAccessor
Usada pelo CEnumerator para acessar os dados do conjunto de linhas do enumerador. Esse conjunto de linhas consiste nas fontes de dados e enumeradores visíveis do enumerador atual.

CSession
Representa uma sessão de acesso ao banco de dados individual. Uma ou mais sessões podem ser associadas a cada objeto CDataSource.

Classe do acessador

CAccessor
Usada para registros que estão estaticamente associados a uma fonte de dados. Use essa classe de acessador quando souber a estrutura da fonte de dados.

CAccessorBase
Classe base para as classes de acessador.

CDynamicAccessor
Um acessador que pode ser criado em tempo de execução, com base nas informações de coluna do conjunto de linhas. Use essa classe para recuperar dados se você não souber a estrutura da fonte de dados.

CDynamicParameterAccessor
Um acessador que pode ser usado quando os tipos de comando são desconhecidos. Obtém as informações de parâmetro chamando a interface ICommandWithParameters, se o provedor dá suporte à interface.

CDynamicStringAccessor
Permite que você acesse uma fonte de dados quando não tiver conhecimento da estrutura subjacente do banco de dados.

CDynamicStringAccessorA
Semelhante a CDynamicStringAccessor, exceto que essa classe solicita dados acessados do armazenamento de dados como dados de cadeia de caracteres ANSI.

CDynamicStringAccessorW
Semelhante a CDynamicStringAccessor, exceto que essa classe solicita dados acessados do armazenamento de dados como dados de cadeia de caracteres UNICODE.

CManualAccessor
Um acessador com métodos para lidar com colunas e parâmetros de comando. Com essa classe, você pode usar qualquer tipo de dados, desde que o provedor possa converter o tipo.

CNoAccessor
Pode ser usado como um argumento de modelo quando não quiser que a classe dê suporte a parâmetros ou colunas de saída.

CXMLAccessor
Semelhante a CDynamicStringAccessor, exceto que essa classe converte todos os dados acessados do armazenamento de dados como dados formatados em XML (marcados).

Classes do conjunto de linhas

CAccessorRowset
Encapsula um conjunto de linhas e os acessadores associados.

CArrayRowset
Usada para acessar elementos de um conjunto de linhas usando a sintaxe de matriz.

CBulkRowset
Usada para buscar e manipular linhas em massa recuperando vários identificadores de linha com apenas uma chamada.

CNoRowset
Poderá ser usado como um argumento de modelo se o comando não retornar um conjunto de linhas.

CRestrictions
Usada para especificar restrições para conjuntos de linhas de esquema.

CRowset
Usada para manipular, definir e recuperar dados de conjunto de linhas.

CStreamRowset
Retorna um objeto ISequentialStream em vez de um conjunto de linhas; em seguida, você usa o método Read para recuperar dados no formato XML. (O SQL Server 2000 faz a formatação; observe que esse recurso funciona apenas com SQL Server 2000.)

IRowsetNotifyImpl
Fornece uma implementação fictícia para IRowsetNotify, com funções vazias para os métodos OnFieldChange, OnRowChange e OnRowsetChange de IRowsetNotify.

Classes typedef e classes de conjunto de linhas de esquema

Os modelos OLE DB fornecem um conjunto de classes que correspondem aos conjuntos de linhas do esquema do OLE DB.

Classes de comando

CCommand
Usada para definir e executar um comando OLE DB baseado em parâmetro. Para apenas abrir um conjunto de linhas simples, use CTable em vez disso.

CMultipleResults
Usada como um argumento de modelo para o modelo CCommand quando você deseja que o comando lide com vários conjuntos de resultados.

CNoAccessor
Usada como um argumento de modelo para classes de modelo, como CCommand e CTable, que usam um argumento de classe do acessador. Use CNoAccessor se você não quiser que a classe dê suporte a parâmetros ou colunas de saída.

CNoMultipleResults
Usado como um argumento de modelo para o modelo CCommand quando você deseja que o comando manipule um conjunto de linhas. CNoMultipleResults é o valor padrão do argumento do modelo.

CNoRowset
Usada como um argumento de modelo para CCommand ou CTable se o comando ou tabela não retorna um conjunto de linhas.

CTable
Usada para acessar um conjunto de linhas simples sem parâmetros.

Classes de propriedade

CDBPropIDSet
Usada para passar uma matriz de IDs de propriedade para as quais o consumidor deseja informações de propriedade. As propriedades pertencem a um conjunto de propriedades.

CDBPropSet
Usada para definir propriedades em um provedor.

Classe de indicador

CBookmark
Usada como um índice para acessar dados em um conjunto de linhas.

Classe de erro

CDBErrorInfo
Usada para recuperar informações de erro do OLE DB.

Confira também

Referência dos modelos de provedor do OLE DB
Modelos do OLE DB