Como: Criar e configurar adaptadores dados manualmente

Artigo
08/25/2010

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.

Observação:
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.

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.

Observação:
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.