Como: Criar e configurar adaptadores dados manualmente
Você pode criar adaptadores de dados sem utilizar um assistente.Não importa como você tenha criado o adaptador, você pode sempre fazer alterações de configuração nele.
![]() |
---|
Na versão anterior do Visual Studio, adaptadores de dados eram usados para comunicação entre um aplicativo e um banco de dados. Enquanto adaptadores de dados são ainda um componente principal do .NET Framework Providers Dados, TableAdapters são componentes gerados pelo designer que simplificam o processo de mover dados entre seu aplicativo e um banco de dados.Para obter mais informações sobre como trabalhar com TableAdapters, consulte Visão geral do TableAdapter. |
![]() |
---|
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio. |
Por padrão no Visual Studio, o suporte em tempo de design para adaptadores de dados foi desativado.Para ter esse suporte para adaptadores de dados, você deve adicioná-los para a Toolbox, conforme descrito no primeiro procedimento abaixo.
Para adicionar adaptadores de dados, conexões e comandos para a Toolbox
Clique com o botão direito do mouse na Toolbox e escolha Choose Items.
Selecione os itens que você deseja adicionar da guia .NET Framework Components da caixa de diálogo Choose Toolbox Items.Por exemplo, para usar o .NET Framework Data Provider for SQL Server, selecione o SqlDataAdapter, SqlConnection e SqlCommand.
Clique em OK para adicionar os itens selecionados para a Toolbox.
Para criar um adaptador de dados manualmente
Verifique se um objeto de conexão está disponível para o formulário ou componente com o qual você estiver trabalhando.Para obter detalhes sobre como adicionar uma conexão autônoma, consulte Establishing a Conexão.
Da guia Data da Toolbox, arraste um objeto OleDbDataAdapter, SqlDataAdapter, OdbcDataAdapter, ou OracleDataAdapter para a superfície de design.
O designer adiciona uma instância do adaptador ao formulário ou componente e inicia o Data Adapter Configuration Wizard.
Feche o assistente.
Para configurar um adaptador de dados manualmente
Selecione o adaptador, e na janela Properties, configure os comandos usados para ler e atualizar dados.Você deve configurar o objeto SelectCommand.Se o adaptador será usado para atualizar uma fonte de dados, você deve configurar também os objetos UpdateCommand, DeleteCommand e InsertCommand.
Para cada objeto de comando, defina as propriedades a seguir.
Propriedade
Descrição
Conexão Ativa
Defina para fazer referência a um objeto de conexão.Você pode criar um objeto de conexão a partir da propriedade ActiveConnection na janela Properties.Normalmente, cada objeto de comando irá referenciar o mesmo objeto de conexão, mas você tem a opção de usar diferentes conexões para cada comando se seu aplicativo assim requerir.
Texto de Comando
O texto de um Instrução SQL ou o nome de um procedimento armazenado.
Para alguns provedores, você pode incluir várias instruções ou nomes de procedimento armazenado na propriedade CommandText, delimitadas por ponto-e-vírgula (;).As instruções ou procedimentos são executados sequencialmente.Isso é útil para situações tais como a emissão de uma declaração SELECT após uma atualização ou uma declaração INSERT para obter registros atualizados e quaisquer valores gerados automaticamente (tais como valores padrão ou de incremento automático).
Tipo de Comando
Um valor que indica como o valor da propriedade CommandText deve ser interpretado:
Text - o comando é um Instrução SQL.
StoredProcedure - o comando é uma referência a um procedimento armazenado.
TableDirect - o texto não é um comando, mas o nome de uma tabela.
Parâmetros
Uma coleção de objetos do tipo Parameter que você configura para passar valores para o comando.No objeto SelectCommand, você cria uma coleção de parâmetros somente se o comando incluir um espaço reservado para parâmetro.Objetos UpdateCommand, InsertCommand, e DeleteCommand sempre requerem parâmetros.Para obter detalhes, consulte:Como: configurar Parameters for dados Adapters.
Se você não quiser os mesmos nomes de coluna na fonte de dados e no dataset, altere os mapeamentos.O valor padrão para a propriedade MissingMappingAction, Passthrough, irá gerar os mesmos nomes na fonte de dados e no conjunto de dados automaticamente.Para obter mais informações, consulte Como: Mapear dados-fonte Columns to Dataset dados-tabela Columns.
No menu Data, escolha Generate DataSet.
Dica:
Se você não vir o Dados menu, clicar qualquer lugar no formulário ou componente designer; o menu aparece somente se o designer tiver o foco.
Se você deseja ver como o adaptador de dados preencherá um dataset, visualize os resultados.Para obter mais informações, consulte Como: Visualização dados-adaptador resultados.
Consulte também
Conceitos
Preenchendo um DataSet de um DataAdapter
Criando aplicativos de dados usando Visual Studio