Registros de usuário

Observação

O Assistente de Consumidor OLE DB da ATL não está disponível no Visual Studio 2019 e posteriores. Ainda é possível adicionar a funcionalidade manualmente. Saiba mais em Criação de um consumidor sem usar um assistente.

Para usar um acessador estático (ou seja, um acessador derivado de CAccessor), o consumidor deve ter um registro de usuário. O registro de usuário é uma classe C++ que contém os elementos de dados para manipular a entrada ou a saída. O Assistente de Consumidor OLE DB da ATL gera um registro de usuário para seu consumidor. Você pode adicionar métodos ao registro do usuário para tarefas opcionais, como manipulação de comandos.

O código a seguir mostra um registro de exemplo que manipula os comandos. No registro de usuário, BEGIN_COLUMN_MAP representa um conjunto de linhas de dados passado de um provedor para o consumidor. BEGIN_PARAM_MAP representa um conjunto de parâmetros de comando. Este exemplo usa uma classe CCommand para manipular os parâmetros de comando. Os membros de dados nas entradas do mapa representam deslocamentos em um bloco contíguo de memória para cada instância da classe. As macros COLUMN_ENTRY correspondem às macros PROVIDER_COLUMN_ENTRY no lado do provedor.

Saiba mais sobre as macros COLUMN_MAP e PARAM_MAP em Macros para modelos de consumidor OLE DB.

class CArtists
{
public:
// Data Elements
   CHAR m_szFirstName[20];
   CHAR m_szLastName[30];
   short m_nAge;

// Column binding map
BEGIN_COLUMN_MAP(CArtists)
   COLUMN_ENTRY(1, m_szFirstName)
   COLUMN_ENTRY(2, m_szLastName)
   COLUMN_ENTRY(3, m_nAge)
END_COLUMN_MAP()

// Parameter binding map
BEGIN_PARAM_MAP(CArtists)
   COLUMN_ENTRY(1, m_nAge)
END_PARAM_MAP()
};

Registros de usuário gerados pelo assistente

Usando o Assistente de Consumidor OLE DB da ATL para gerar um consumidor, você tem a opção de usar modelos ou atributos OLE DB. O código gerado é diferente em cada caso. Saiba mais sobre esse código em Classes geradas pelo assistente do consumidor.

Suporte ao registro de usuário para vários acessadores

Confira uma discussão detalhada dos cenários nos quais você precisa usar vários acessadores em Uso de vários acessadores em um conjunto de linhas.

O exemplo a seguir mostra o registro de usuário modificado para ser compatível com vários acessadores no conjunto de linhas. Em vez de BEGIN_COLUMN_MAP e END_COLUMN_MAP, ele usa BEGIN_ACCESSOR_MAP e BEGIN_ACCESSOR para cada acessador. A macro BEGIN_ACCESSOR especifica o número do acessador (deslocamento a partir de zero) e se o acessador é automático. Os acessadores automáticos chamam GetData para recuperar dados automaticamente em um chamada a MoveNext. Os acessadores não automáticos exigem que você recupere os dados explicitamente. Use um acessador não automático se estiver fazendo a associação a um campo de dados grande (como uma imagem de bitmap) que você pode não querer recuperar para cada registro.

class CMultiArtists
{
public:
// Data Elements
   CHAR m_szFirstName[20];
   CHAR m_szLastName[30];
   short m_nAge;

// Column binding map
BEGIN_ACCESSOR_MAP(CMultiArtists, 2)
   BEGIN_ACCESSOR(0, true)    // true specifies an auto accessor
    COLUMN_ENTRY(1, m_szFirstName)
    COLUMN_ENTRY(2, m_szLastName)
   END_ACCESSOR()
   BEGIN_ACCESSOR(1, false)   // false specifies a manual accessor
    COLUMN_ENTRY(3, m_nAge)
   END_ACCESSOR()
END_ACCESSOR_MAP()
};

Confira também

Modelos de consumidor OLE DB