ATL OLE DB consumidor assistente

Este assistente define uma classe de consumidor OLEDB com as ligações de dados necessário para acessar a fonte de dados especificada por meio do provedor OLE DB especificado.

Observação:
Este assistente requer que você clicar no Fonte de dados botão para selecionar uma fonte de dados antes de inserir nomes no Class e arquivo .h campos.

• Data Source
  The Fonte de dados botão permite que você configurou a fonte de dados especificado usando o provedor OLE DB especificado.Quando você clica neste botão, a Propriedades do vínculo de dados caixa de diálogo é exibida.Para obter mais informações sobre a criação de seqüências de caracteres de conexão e o Propriedades do vínculo de dados caixa de diálogo, consulte Visão geral da API de link de dados in the Windows SDK documentação.

  Observação:
  Em versões anteriores, clicando em deslocar a Fonte de dados botão aberta uma caixa de diálogo em em aberto arquivo para permitir que você selecionar um arquivo de vínculo de dados (.udl).Não há mais suporte para essa funcionalidade.

  A caixa de diálogo possui quatro guias:

  • Provedor guia

  • Conexão guia

  • Avançado guia

  • Todos os guia

• Class
  Depois de selecionar uma fonte de dados, essa caixa é preenchida com um nome de classe padrão com base na tabela ou procedimento armazenado selecionado (consulte Selecione uma fonte de dados abaixo).Você pode edição o nome de classe.

• arquivo .h
  Depois de selecionar uma fonte de dados, essa caixa é preenchida com um nome de classe do cabeçalho padrão com base na tabela ou procedimento armazenado selecionado (consulte Selecione uma fonte de dados abaixo).Você pode edição o nome do arquivo de cabeçalho ou selecionar um arquivo de cabeçalho existente.

• Atribuído
  Esta opção especifica se o assistente irá criar classes consumidor usando atributos ou declarações do modelo.Quando você selecionar essa opção, o assistente usa atributos em vez de declarações do modelo (isso é a opção padrão).Quando você desmarcar essa opção, o assistente usa o modelo declarações em vez de atributos.

  • Se você selecionar um consumidor Tipo da tabela, o assistente usa o db_source e db_table atributos ao criar a tabela e tabela acessador declarações de classe e usa db_column para criar o MAP de coluna, por exemplo:

    // Inject table class and table accessor class declarations
    [
        db_source("<initialization_string>"),
        db_table("dbo.Orders")
    ]
    ...
    // Column map
        [ db_column(1, status=m_dwOrderIDStatus,         length=m_dwOrderIDLength) ] LONG m_OrderID;
        [ db_column(2, status=m_dwCustomerIDStatus,         length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
        ...
    

    em vez de usar o CTable classe de modelo para declarar a tabela e classe de acessador de tabela e as macros BEGIN_COLUMN_MAP e END_COLUMN_MAP para criar o MAP de coluna, por exemplo:

    // Table accessor class
    class COrdersAccessor;
    // Table class
    class COrders : public CTable<CAccessor<COrdersAccessor> >;
    ...
    // Column map
    BEGIN_COLUMN_MAP(COrderDetailsAccessor)
        COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID,         m_dwOrderIDLength, m_dwOrderIDStatus)
        COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID,         m_dwCustomerIDLength, m_dwCustomerIDStatus)
        ...
    END_COLUMN_MAP()
    

  • Se você selecionar um consumidor Tipo do comando, o assistente usa o db_source e db_command atributos e usos db_column para criar o MAP de coluna, por exemplo:

    [
        db_source("<initialization_string>"),
        db_command("SQL_command")
    ]
    ...
    // Column map using db_column is the same as for consumer type of 'table'
    

    em vez de usar o comando e o comando acessador classe declarações no arquivo .h da classe de comando, por exemplo:

    Command accessor class:
    class CListOrdersAccessor;
    Command class:
    class CListOrders : public CCommand<CAccessor<CListOrdersAccessor> >;
    ...
    // Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
    // for consumer type of 'table'
    

  Consulte Basic Mechanics of Atributos para obter mais informações.

• Type (Tipo)
  selecionar um dos seguintes botões de opção para especificar se a classe de consumidor será derivada da CTable ou CCommand (padrão).

  • Tabela
    selecionar esta opção se você deseja usar CTable ou db_table para criar a tabela e a tabela acessador declarações de classe.

  • Comando
    selecionar esta opção se você deseja usar CCommand ou db_command para criar o comando e o comando acessador declarações de classe.Esta é a seleção padrão.

• Suporte
  selecionar as caixas de seleção para especificar os tipos de atualizações para ter suporte no consumidor (o padrão é none).Cada um dos seguintes definirá DBPROP_IRowsetChange e as entradas apropriadas para DBPROP_UPDATABILITY na propriedade conjunto MAP.

  • Alterar
    Especifica que o consumidor suporte a atualizações de dados de linha no conjunto de linhas.

  • Inserir
    Especifica que o consumidor oferecem suporte a inserção de linhas no conjunto de linhas.

  • Excluir
    Especifica que o consumidor oferecem suporte a exclusão de linhas do conjunto de linhas.

Consulte também

Tarefas

Adicionando um consumidor de BD OLE DB ATL

Conceitos

Adicionando funcionalidade com assistentes de código

Referência

Cadeias de caracteres de conexão e vínculos de dados (OLE DB)