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

Os modelos do consumidor OLE DB contêm as seguintes classes. Material de referência também inclui tópicos em macros para modelos do consumidor OLE DB.

Classes de sessão

• CDataConnection
  Gerencia a conexão com a fonte de dados. Esta é uma classe útil para criar clientes como encapsula objetos necessários para a fonte de dados (e) e qualquer sessão de trabalho que você precisa fazer ao conectar-se 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 do base de dados, cada um representado por um objeto de CSession , podem ocorrer em uma única conexão.

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

• CEnumeratorAccessor
  Usado por CEnumerator para acessar os dados do conjunto de linhas do enumerador. Esse conjunto de linhas consiste em fontes de dados e nos enumeradores visíveis do enumerador atual.

• CSession
  Representa uma única sessão de acesso ao base de dados. Uma ou mais sessões podem ser associadas com cada objeto de CDataSource .

Classes de acessador

• CAccessor
  Usado para os registros que são estatisticamente associados a uma fonte de dados. Use essa classe do acessador quando você conhece a estrutura da fonte de dados.

• CAccessorBase
  Classe base para todas as classes do 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 ao chamar a interface de ICommandWithParameters , se o provedor oferece suporte à interface.

• CDynamicStringAccessor
  Permite acessar uma fonte de dados quando você não tem conhecimento da estrutura subjacente da base de dados.

• CDynamicStringAccessorA
  Semelhante a CDynamicStringAccessor exceto pelo fato dessa classe solicita os dados acessados no repositório de dados como dados de cadeia de caracteres ANSI.

• CDynamicStringAccessorW
  Semelhante a CDynamicStringAccessor exceto pelo fato dessa classe solicita os dados acessados no repositório de dados como dados de cadeia de caracteres UNICODE.

• CManualAccessor
  Um acessador com os métodos para tratar colunas e parâmetros do comando. Com essa classe, você pode usar qualquer tipo de dados como o provedor pode converter o tipo.

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

• CXMLAccessor
  Semelhante a CDynamicStringAccessor exceto pelo fato dessa classe converte todos os dados acessados no repositório de dados marcados como dados () em formato XML.

Classes do conjunto de linhas

• CAccessorRowset
  Encapsula um conjunto de linhas e os acessadores associados.

• CArrayRowset
  Usado para acessar os elementos de um conjunto de linhas usando a sintaxe da matriz.

• CBulkRowset
  Usado para buscar e manipular linhas em massa recuperando a vários identificadores de linha com uma única chamada.

• CNoRowset
  Pode ser usado como um argumento de modelo se o comando não retorna um conjunto de linhas.

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

• CRowset
  Usado para manipular, defina, e recuperar dados do conjunto de linhas.

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

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

Classes do conjunto de linhas de esquema e classes de Typedef

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

Classes de comando

• CCommand
  Usado para definir e executar um comando de base do OLE DB. Para abrir apenas um conjunto de linhas simples, use CTable em vez disso.

• CMultipleResults
  Usado como um argumento do modelo para o modelo de CCommand quando você quiser que o comando tratar vários conjuntos de resultados.

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

• CNoMultipleResults
  Usado como um argumento do modelo para o modelo de CCommand quando você quiser que o comando tratar um único conjunto de linhas. CNoMultipleResults é o valor padrão para o argumento do modelo.

• CNoRowset
  Usado como um argumento do modelo para CCommand ou CTable se o comando ou tabela não retornam um conjunto de linhas.

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

Classes de propriedade

• CDBPropIDSet
  Usado para passar uma matriz de IDs de propriedade para o consumidor deseja informações da propriedade. As propriedades pertencem a um conjunto de propriedades.

• CDBPropSet
  Usado para definir propriedades em um provedor.

A classe do medidor

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

Classe de erro

• CDBErrorInfo
  Usado para recuperar informações de erro OLE DB.

Consulte também

Conceitos

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

Outros recursos

Modelos de banco de dados OLE