TableAdapter Assistente de Configuração

Artigo
06/10/2015

O Assistente de configuração do TableAdapter cria e edita TableAdapters. O assistente cria TableAdapters com base em instruções SQL inseridas ou em procedimentos existentes armazenados no banco de dados. O assistente também pode criar novos procedimentos armazenados no banco de dados com base em instruções SQL inseridas no assistente.

Um TableAdapter se conecta a um banco de dados, executa consultas ou procedimentos armazenados em um banco de dados e preenche uma DataTable com os dados retornados pela consulta ou pelo procedimento armazenado. Além de preencher tabelas de dados existentes com dados, TableAdapters podem retornar novas tabelas de dados preenchidas com dados. Para obter mais informações, consulte Visão geral de TableAdapter.

Executando o assistente

Execute o assistente para criar ou editar TableAdapters e suas DataTables associadas. Para obter mais informações, consulte Como iniciar o assistente de configuração TableAdapter.

Escolha a Conexão de Dados

Escolha uma conexão existente na lista de conexões ou clique em Nova Conexão para criar uma conexão com o banco de dados.

Ao concluir a caixa de diálogo Propriedades da Conexão, a área Detalhes da Conexão exibe informações somente leitura sobre o provedor selecionado, bem como a cadeia de caracteres de conexão.

Salvar a cadeia de conexão no arquivo de configuração do aplicativo

Escolha Sim, salvar a conexão como para armazenar a cadeia de conexão no arquivo de configuração do aplicativo. Digite um nome para a conexão ou use o nome padrão fornecido.

Salvar cadeias de caracteres de conexão no arquivo de configuração do aplicativo simplifica o processo de manutenção do aplicativo se a conexão com o banco de dados for alterada. Em caso de alteração na conexão com o banco de dados, é possível editar a cadeia de caracteres de conexão no arquivo de configuração do aplicativo. Dessa maneira, não será necessário editar o código-fonte e recompilar o aplicativo. Para obter informações sobre a edição de uma cadeia de caracteres de conexão no arquivo de configuração do aplicativo, consulte Como salvar e editar cadeias de conexão.

Observação de segurança
As informações são armazenadas no arquivo de configuração do aplicativo como texto simples.Para reduzir a possibilidade de acesso não autorizado a informações confidenciais, é possível criptografar os dados.Para obter mais informações, consulte Criptografando e descriptografando dados.

Escolha um tipo de comando

Escolha qual tipo de comando executar no banco de dados.

Na página Escolha um tipo de comando, selecione a partir dos seguintes métodos de coleta de dados do banco de dados:

Usar instruções SQL permite digitar uma instrução SQL para selecionar os dados do banco de dados.
Criar novos procedimentos armazenados: Selecione esta opção para o assistente criar novos procedimentos armazenados (no banco de dados) com base na instrução SELECT especificada.
Usar procedimentos armazenados existentes: Selecione esta opção para mapear procedimentos armazenados que já existem no banco de dados para os comandos SELECT, INSERT, UPDATE e DELETE do TableAdapter.

Usar Instruções SQL

Esta seção explica como concluir o Assistente de configuração do TableAdapter quando a opção Usar instruções SQL estiver selecionada.

Na página Gerar as instruções SQL, digite a instrução SQL que, quando executada, preencherá a tabela de dados com dados.

A página Visualizar resultados do assistente mostra os resultados da criação do TableAdapter. Se o assistente encontrar qualquer problema, esta página fornecerá as informações sobre o erro.

Escolha Métodos para Gerar

Esta página fornece opções para selecionar quais métodos do TableAdapter o assistente gera para coleta e atualização de dados.

Preencher uma DataTable
Cria o método padrão do TableAdapter para preencher a tabela de dados. Passe o nome da tabela de dados como parâmetro ao chamar este método.

Opcionalmente, é possível alterar o nome padrão na caixa Nome do Método.
Retornar uma DataTable
Cria o método do TableAdapter para retornar uma tabela de dados preenchida. Em determinados aplicativos, pode ser mais vantajoso retornar uma tabela de dados preenchida ao invés de preencher a tabela de dados existente com dados.

Opcionalmente, é possível alterar o nome padrão na caixa Nome do Método.
Criar métodos para enviar atualizações diretamente para o banco de dados
Cria os comandos INSERT, UPDATE e DELETE necessários para escrever alterações ao banco de dados subjacente. Selecionar esta caixa é o equivalente a definir a propriedade GenerateDBDirectMethods como verdadeira.

Dica

Esta opção fica indisponível quando a instrução SQL original não fornecer informações suficientes ou a consulta não for uma consulta atualizável.Essa situação pode ocorrer, por exemplo, em consultas JOIN e consultas que retornam um valor único (escalar).

Criar novos procedimentos armazenados

Esta seção explica como concluir o Assistente de configuração do TableAdapter ao selecionar a opção Criar novos procedimentos armazenados.

Na página Gerar os procedimentos armazenados, insira a instrução SQL que preenche a tabela de dados. Essa será a instrução SELECT do TableAdapter e a base para criar os procedimentos armazenados para selecionar, atualizar, inserir e excluir dados.
Na página Criar os procedimentos armazenados, faça o seguinte:
1. Digite um nome para o novo procedimento armazenado.
2. Especifique se o procedimento armazenado será criado no banco de dados subjacente.
  
  Dica
  
  A capacidade de criar procedimentos armazenados no banco de dados é determinada pelas configurações de segurança e permissões do banco de dados específico.Por exemplo, se não houver permissão para criar novos procedimentos armazenados no banco de dados, essa opção não poderá ser concluída.
A página Visualizar resultados do assistente mostra os resultados da criação do TableAdapter. Se o assistente encontrar qualquer problema, esta página fornecerá as informações sobre o erro.

Usar procedimentos armazenados existentes

Esta seção explica como concluir o Assistente de configuração do TableAdapter ao selecionar a opção Usar procedimentos armazenados existentes.

Associar comandos a procedimentos armazenados existentes

Selecione o procedimento armazenado para executar para os comandos SELECT, INSERT, UPDATE e DELETE do TableAdapter. Esses procedimentos armazenados são executados quando os métodos associados são chamados no TableAdapter. Por exemplo, o procedimento armazenado atribuído ao comando Atualizar é executado quando o método TableAdapter.Update() é chamado.

Mapear parâmetros desde o procedimento armazenado selecionado até as colunas correspondentes na tabela de dados. Por exemplo, se o procedimento armazenado aceitar um parâmetro chamado @CompanyName que é passado para a coluna CompanyName na tabela, defina a Coluna de origem do parâmetro @CompanyName para CompanyName.

Dica

O procedimento armazenado atribuído ao comando SELECT é executado chamando o método do TableAdapter nomeado na próxima etapa do assistente.O padrão é Fill, de modo que o código típico para executar o procedimento SELECT é TableAdapter.Fill(tableName).Substituir Fill pelo nome atribuído ao alterá-lo do padrão de Preencher e substituir "TableAdapter" pelo nome real do TableAdapter (por exemplo, CustomersTableAdapter).

Opções avançadas

Clicar em Opções avançadas acessa as seguintes opções avançadas do TableAdapter.

Gerar instruções Inserir, Atualizar e Excluir

Ao selecionar esta opção, o assistente tentará gerar as instruções INSERT, UPDATE e DELETE com base na instrução SELECT definida na página Gerar instruções SQL.
Usar simultaneidade otimista

Selecionar esta opção modifica as instruções UPDATE e DELETE para detectar se registros individuais foram modificados desde que foram originalmente lidos para a tabela de dados. Uma exceção é lançada quando violações de simultaneidade são detectadas.
Atualizar a DataTable

Selecionar esta opção atualiza os dados na tabela após executar as instruções INSERT e UPDATE.

Próximas Etapas

Após o assistente estar concluído, o TableAdapter é incluído no conjunto de dados e fica disponível para visualização e edição no Designer de Conjunto de Dados. É possível realizar uma série de etapas após isso.

Incluir mais TableAdapters. O assistente cria um TableAdapter. Se desejar usar um conjunto de dados que contém múltiplas tabelas, provavelmente será melhor incluir mais TableAdapters no conjunto de dados.
Incluir consultas adicionais no TableAdapter. Para obter mais informações, consulte Como criar consultas TableAdapter.
Visualize esse conjunto de dados no Janela Fontes de Dados e arraste itens sobre o(s) formulário(s) para criar controles associados a dados. Para obter mais informações, consulte Associando controles dos Windows Forms a dados no Visual Studio.

Consulte também

Compartilhar via