Assistente de Configuração para o TableAdapter

Artigo
08/01/2011

O TableAdapter Configuration Wizard cria e edita TableAdapters. O assistente cria TableAdapters baseados em instruções SQL que você inserir ou em procedimentos armazenados no banco de dados existente. O assistente também pode criar novos procedimentos armazenados no banco de dados com base em instruções SQL que você inserir 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 procedimento armazenado. Além disso, para 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 do TableAdapter.

Executar o Assistente

Execute o assistente para criar ou editar TableAdapters e seus DataTables associados. Para obter mais informações, consulte Como: Iniciar o TableAdapter Configuration Wizard..

Escolha sua conexão de dados

Escolha uma conexão existente da lista de conexões ou clique em New Connection para abrir o Adicionar/modificar a caixa de diálogo de conexão (geral) e criar uma conexão ao seu banco de dados.

Após a conclusão da caixa de diálogo Connection Properties, a área Connection Details exibe informações sobre o provedor selecionado, bem como a sequência de conexão somente para leitura.

Salvar a sequência de caracteres de conexão para o arquivo de configuração do aplicativo

Escolha Yes, save the connection as para armazenar a sequência 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 sequências de conexão no arquivo de configuração aplicativo simplifica o processo de manutenção de seu aplicativo, se você alterar a conexão de banco de dados. No caso de uma alteração na conexão de banco de dados, você pode editar a sequência de conexão no arquivo de configuração do aplicativo. Dessa forma, não é necessário editar o código-fonte e recompilar seu aplicativo. Para obter informações sobre a edição um sequência de caracteres de conexão em arquivo de configuração do aplicativo, consulte Como: Salvar e editar seqüências de conexão.

Observação sobre segurança
As informações são armazenadas no arquivo de configuração do aplicativo como texto sem-formatação. Para reduzir a possibilidade de acesso não autorizado a informações confidenciais, convém criptografar seus dados. Para obter mais informações, consulte Criptografando e descriptografando dados.

Choose a Command Type

Escolha que tipo de comando executar no banco de dados.

Na página Choose a Command Type, selecione um dos seguintes métodos de busca de dados a partir do banco de dados:

Use SQL statements Permite que você digite uma instrução SQL para selecionar os dados do seu banco de dados.
Criar novos procedimentos armazenados: Selecione esta opção para que o Assistente para criar novos procedimentos armazenados (no banco de dados) com base na declaração SELECT especificada.
Use existing stored procedures: Selecione esta opção para mapear procedimentos armazenados que já existem no seu banco de dados para o SELECT, INSERT, UPDATE e excluir comandos do TableAdapter.

Use instruções SQL

Esta seção explica como concluir o TableAdapter Configuration Wizard quando a opção Use SQL statements está selecionada.

Na página Generate the SQL statements, digite a instrução SQL que, quando executada, preencherá a tabela de dados com dados.

Observação
O assistente fornece acesso ao Query Builder, uma ferramenta visual para criar consultas SQL. Para abri-lo, clique no botão Query Builder. Para obter mais informações sobre o uso do Query Builder, consulte Query and View Designer Tools.

A página View Wizard Results mostra os resultados de criar o TableAdapter. Se o assistente encontrar problemas, esta página fornece as informações de erro.

Escolha métodos para gerar

Esta página fornece opções para selecionar quais métodos do TableAdapter o assistente gera para buscar e atualizar dados.

Preencher uma tabela de dados
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, você pode alterar o nome padrão na caixa Method Name.
Retornar uma tabela de dados
Cria o método do TableAdapter para retornar uma tabela de dados preenchida. Em determinados aplicativos, pode ser mais desejável retornar uma tabela de dados preenchida em oposição a preencher a tabela de dados existente com dados.

Opcionalmente, você pode alterar o nome padrão na caixa Method Name.

Criar métodos para enviar atualizações diretamente para o banco de dados
Cria os comandos INSERT, UPDATE e DELETE, necessários para gravar alterações no banco de dados subjacente. Selecionar esta caixa é o equivalente a configurar a propriedadede GenerateDBDirectMethods como verdadeira.

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

Crie novos procedimentos armazenados

Esta seção explica como concluir o TableAdapter Configuration Wizard quando a opção Create new stored procedures for selecionada.

Na página Generate the stored procedures, insira a instrução SQL que preenche a tabela de dados. Isso será a instrução SELECT do TableAdapter do e a base para criar os procedimentos armazenados para selecionar, atualizar, inserir, e excluir dados.

Observação
O assistente fornece acesso ao Query Builder, uma ferramenta visual para criar consultas SQL. Para abri-lo, clique no botão Query Builder. Para obter mais informações sobre o uso do Query Builder, consulte Query and View Designer Tools ou pressione F1 naquela caixa de diálogo.

Na página Create the Stored Procedures, faça o seguinte:

Digite um nome para o novo procedimento armazenado.

Especifique se deseja criar o procedimento armazenado no banco de dados subjacente.

Observação
A capacidade para criar procedimentos armazenados no banco de dados é determinada pelas configurações de segurança e permissões para o banco de dados específico. Por exemplo, se você não tiver permissão para criar novos procedimentos armazenados no banco de dados, esta opção não pode ser concluída.

A página View Wizard Results mostra os resultados de criar o TableAdapter. Se o assistente encontrar problemas, esta página fornece as informações de erro.

Use procedimentos armazenados existentes

Esta seção explica como concluir o TableAdapter Configuration Wizard quando a opção Use existing stored procedures for selecionada.

Vincule Comandos a Procedimentos Armazenados Existentes

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

Mapeie parâmetros do procedimento armazenado selecionado para as colunas correspondentes na tabela de dados. Por exemplo, se seu procedimento armazenado aceita um parâmetro chamado @CompanyName que ele passa à coluna CompanyName na tabela, configure o Source Column do parâmetro @CompanyName para CompanyName.

Observação
O procedimento armazenado atribuído para o comando SELECT é executado chamando-se o método do TableAdapter que você nomeia na próxima etapa do assistente. O padrão é Fill, portanto o código típico para executar o procedimento SELECT é TableAdapter.Fill(tableName). Substitua Fill com o nome que você atribui se você alterá-lo em relação ao padrão de Fill, e substitua "TableAdapter" com o nome real do TableAdapter (por exemplo, CustomersTableAdapter).

O procedimento armazenado atribuído para o comando SELECT é executado chamando-se o método do TableAdapter que você nomeia na próxima etapa do assistente. O padrão é Fill, portanto o código típico para executar o procedimento SELECT é TableAdapter.Fill(tableName). Substitua Fill com o nome que você atribui se você alterá-lo em relação ao padrão de Fill, e substitua "TableAdapter" com o nome real do TableAdapter (por exemplo, CustomersTableAdapter).

Advanced Options

Clicar Advanced Options acessa as seguintes opções avançadas do TableAdapter. Para obter mais informações, consulte Caixa de Diálogo Advanced SQL Generation Options.

Gerar instruções Insert, Update e Delete

Quando você seleciona essa opção, o assistente tentará gerar instruções INSERT, UPDATE e DELETE com base na instrução SELECT definida na página Generate SQL statements.
Usar concorrência otimista

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

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

Próximas etapas

Após ter concluído o assistente, o TableAdapter é adicionado ao dataset e está disponível para exibição e edição no Dataset Designer. Você pode executar uma série de etapas depois disso.

Adicione mais TableAdapters. O assistente cria um TableAdapter. Se você pretende usar um dataset que contém várias tabelas, você provavelmente deseja adicionar mais TableAdapters ao dataset.
Adicione consultas adicionais ao TableAdapter. Para obter mais informações, consulte Como: Criar consultas TableAdapter.
Visualize este DataSet em Janela Fontes de Dados e arraste os itens para seus formulários para criar controles vinculados a dados. Para obter mais informações, consulte Vinculação de controles do Windows Forms a dados em Visual Studio.

Consulte também

Compartilhar via