Partilhar via


Assistente de Configuração para o TableAdapter

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 configuração assistente.

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 Conexão Caixa de diálogo Box (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: edição uma cadeia de conexão.

Observação de 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: selecionar esta opção para que o assistente criar novos procedimentos armazenados (no banco de dados) com base na demonstrativo selecionar especificada.

  • Use existing stored procedures: selecionar esta opção para MAP armazenados procedimentos que já existem no seu banco de dados para selecionar, INSERT, atualização 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 para o Construtor de consultas, 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 Consulta and Exibir Designer Tools.

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.

  1. 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 para o Construtor de consultas, 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 Consulta and Exibir Designer Tools ou pressione F1 naquela caixa de diálogo.

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

    1. Digite um nome para o novo procedimento armazenado.

    2. 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 selecionar é 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 Exibindo visão geral de dados.

Consulte também

Tarefas

Como: Criar consultas TableAdapter

Como: Editar consultas do TableAdapter

Como: Conectar-se a Dados em um Banco de Dados

Demonstra Passo a passo: Exibindo dados em um formulário em um aplicativo do Windows

Conceitos

O que Há de Novo em Dados

Exibindo visão geral de dados

Dataset Designer

Visão geral sobre fontes de dados

Referência

Assistente de configuração da consulta TableAdapter

Outros recursos

Explicações Passo a passo sobre Dados

Exibindo dados em formulários em aplicativos do Windows

Validando Dados