Compartilhar via

Criando um consumidor simples

  • Artigo

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.

Use o Assistente de Projeto da ATL e o Assistente de Consumidor OLE DB do ATL para gerar um consumidor de modelos de OLE DB.

Para criar um aplicativo de console para um consumidor de OLE DB

  1. No menu Arquivo, clique em Novo e clique em Projeto.

    A caixa de diálogo Novo Projeto aparece.

  2. No painel Tipos de projeto, clique na pasta Instalado>Visual C++>Área de Trabalho do Windows e clique no ícone Assistente do Windows Desktop no painel Modelos. Na caixa Nome, digite o nome do seu projeto, por exemplo, MeusConsoles.

  3. Clique em OK.

    O assistente Projeto do Windows Desktop é exibido.

  4. Na página Configurações do Aplicativo, selecione Aplicativo de Console e Adicionar arquivos de cabeçalho comuns para ATL.

  5. Clique em OK para fechar o assistente e gerar o projeto.

Em seguida, use o Assistente de Consumidor OLE DB do ATL para adicionar um objeto de consumidor de OLE DB.

Criação de um consumidor com o Assistente de Consumidor OLE DB do ATL

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto MyCons.

  2. No menu de atalho, clique em Adicionar, depois em Novo Item.

    A caixa de diálogo Adicionar Novo Item aparecerá.

  3. No painel Categorias, clique em Instalado>Visual C++ >ATL, clique no ícone do Consumidor de OLEDB da ATL no painel Modelos e clique em Adicionar.

    O Assistente de Consumidor OLEDB do ATL é exibido.

  4. Clique no botão Fonte de Dados.

    A caixa de diálogo Propriedades de associação de dados é exibida.

  5. Na caixa de diálogo Propriedades de associação de dados, faça o seguinte:

    1. Na guia Provedor, especifique um provedor de OLE DB.

    2. Na guia Conexão, especifique as informações necessárias, como nome do servidor, ID de logon e senha para a fonte de dados e o banco de dados no servidor.

      Observação

      Há um problema de segurança com o recurso Permitir salvamento de senha da caixa de diálogo Propriedades de associação de dados. Em Inserir informações para fazer logon no servidor, há dois botões de opção: Usar segurança integrada do Windows NT e Usar um nome de usuário e uma senha específicos.

      Observação

      Se você selecionar Usar nome de usuário e senha específicos, terá a opção de salvar a senha (usando a caixa de seleção Permitir salvamento de senha); no entanto, essa opção não é segura. É recomendável selecionar Usar Segurança Integrada do Windows NT; essa opção usa o Windows NT para verificar sua identidade.

      Observação

      Se você não puder usar a segurança integrada do Windows NT, use um aplicativo de camada intermediária para solicitar a senha ao usuário ou armazenar a senha em um local com mecanismos de segurança para ajudar a protegê-la (em vez de fazer isso no código-fonte).

    3. Depois de selecionar o provedor e outras configurações, clique em Testar Conexão para verificar as seleções feitas nas páginas da caixa de diálogo anterior. Se a caixa Resultados informar Test connection succeeded, clique em OK para criar a associação de dados.

    A caixa de diálogo Selecionar Objeto do Banco de Dados é exibida.

  6. Use o controle de árvore para selecionar uma tabela, exibição ou procedimento armazenado. Neste exemplo, selecione a tabela Products do banco de dados Northwind.

  7. Clique em OK. Esse procedimento levará você de volta ao Assistente de Consumidor OLE DB do ATL.

  8. O assistente preenche os nomes de Class e do arquivo .h com base no nome da tabela, exibição ou procedimento armazenado selecionado. Você pode editar esses nomes se quiser.

  9. Desmarque a caixa de seleção Atribuído para que o assistente crie o código de consumidor usando Classes de modelo OLE DB em vez do padrão Atributos de consumidor OLE DB.

  10. Em Tipo, selecione Comando.

    O assistente cria um consumidor baseado em CCommand se você seleciona Comando ou um consumidor baseado em CTable se você seleciona Tabela. A classe de tabela ou comando é nomeada de acordo com o objeto selecionado, mas você pode editar o nome.

  11. Em Suporte, deixe as caixas Alterar, Inserir e Excluir desmarcadas.

    Selecione as caixas Alterar, Inserir e Excluir para dar suporte à alteração, inserção e exclusão de registros no conjunto de linhas. Saiba mais sobre a gravação de dados no armazenamento de dados em Atualizar conjuntos de linhas.

  12. Clique em Concluir para criar o consumidor.

O assistente gera uma classe de comando e uma classe de registro de usuário, conforme mostrado em Classes geradas pelo Assistente do Consumidor. A classe de comando terá o nome que você inseriu na caixa Class no assistente (nesse caso, CProducts), e a classe de registro de usuário terá um nome no formato "NomeClasseAcessador" (nesse caso, CProductsAccessor).

Observação

O assistente coloca a seguinte linha em Products.h:

#error Security Issue: The connection string may contain a password

Observação

Essa linha impede a compilação do aplicativo de consumidor e lembra você de verificar se há senhas codificadas na cadeia de conexão. Depois de verificar a cadeia de conexão, você pode remover essa linha de código.

Confira também

Criando um consumidor do OLE DB usando um assistente