Editando TableAdapters

 

Às vezes, convém alterar o esquema da tabela do adaptador. Para fazer isso, você modifica o primário do adaptador Fill método. TableAdapters são criados com um principal Fill método que define o esquema da tabela de dados associada. Principal Fill método é baseado na consulta ou procedimento armazenado que você inseriu quando você originalmente configurou o TableAdapter; é o primeiro método (superior) sob a tabela de dados sobre o Criando e editando conjuntos de dados tipados.

As alterações que você fizer ao TableAdapter principal do Fill método são refletidas no esquema da tabela de dados associada. Por exemplo, remover uma coluna da consulta no principal Fill método também remove a coluna da tabela de dados associada. Além disso, remover a coluna do principal Fill método remove a coluna de quaisquer consultas adicionais para aquele TableAdapter.

Você pode usar o Assistente de configuração de consulta do TableAdapter para criar e editar consultas adicionais de TableAdapter. Essas consultas adicionais devem obedecer ao esquema da tabela, a menos que elas retornam um valor escalar. As consultas adicionais que têm um nome que você especificar (por exemplo, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Para iniciar o Assistente de configuração de consulta do TableAdapter com uma nova consulta

1. Abra o dataset no Dataset Designer.

2. Se você estiver criando uma nova consulta, arraste um consulta de objeto o DataSet guia do Toolbox para um DataTable, ou selecione Add Query no menu de atalho do TableAdapter. Você também pode arrastar um consulta objeto em uma área vazia do Dataset Designer, que cria um TableAdapter sem um associado DataTable. Essas consultas são limitadas a retornar valores únicos (escalares), ou executando UPDATE, INSERT, ou exclua comandos no banco de dados. Para obter mais informações, consulte Como: adicionar consultas globais a um TableAdapter.

3. Sobre o Choose Your Data Connection página, selecione ou crie a conexão que a consulta irá utilizar.

   Dica

   Esta página só aparece quando o designer não pode determinar a conexão apropriada para usar, ou quando nenhuma conexão estiver disponível.

4. Sobre o Escolher um tipo de comando página, selecione os seguintes métodos de busca de dados do banco de dados:

   • Usar instruções SQL permite que você digite uma instrução SQL para selecionar os dados de seu banco de dados.

   • Criar novo procedimento armazenado — Selecione esta opção para que o assistente crie um novo procedimento armazenado com base na instrução SELECT especificada (no banco de dados).

   • Usar procedimentos armazenados existentes — Selecione esta opção para executar um procedimento armazenado existente quando executar a consulta.

Para iniciar o Assistente de configuração de consulta do TableAdapter em uma consulta existente

• Se você estiver editando uma consulta TableAdapter existente, a consulta de atalho e escolha Configurar no menu de atalho.

  Dica

  Clicando duas vezes na consulta principal de um TableAdapter reconfigura o TableAdapter e DataTable esquema, enquanto o mouse em uma consulta adicional em um TableAdapter configura a consulta selecionada. O Assistente de configuração TableAdapter reconfigura a definição do TableAdapter; o Assistente de configuração de consulta do TableAdapter reconfigura somente a consulta selecionada.

Executar o Assistente

Arraste consultas para o Dataset Designer, ou configure consultas existentes (qualquer consulta listada abaixo da primeira consulta).

A primeira consulta em um TableAdapter é a consulta principal do TableAdapter. Editar esta consulta principal abre o Assistente de configuração TableAdapter e edita o esquema da tabela de dados do TableAdapter. Todas as consultas listadas abaixo da consulta principal são consultas adicionais e são configuradas usando o Assistente de configuração de consulta do TableAdapter. Para obter mais informações sobre como executar o assistente, consulte Como iniciar o Assistente de Configuração de Consulta do TableAdapter.

Escolha sua 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 ao banco de dados.

Após a conclusão do Propriedades de conexão caixa de diálogo, o detalhes da conexão área exibe informações somente leitura sobre o provedor selecionado, bem como a cadeia 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 conexão no arquivo de configuração do aplicativo simplifica o processo de manter seu aplicativo se a conexão de banco de dados for alterado. No caso de uma alteração na conexão de banco de dados, você pode editar a cadeia de conexão no arquivo de configuração do aplicativo. Dessa forma, você não precisa editar o código-fonte e recompilar seu aplicativo. Para obter informações sobre como editar uma cadeia de conexão no arquivo de configuração do aplicativo, consulte Como salvar e editar cadeias de conexão.

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

Usar instruções SQL

Esta seção explica como concluir o Assistente de configuração de consulta do TableAdapter ao selecionar o usar instruções SQL opção.

Escolha um tipo de consulta

O assistente cria vários tipos de consultas dependendo dos requisitos do seu aplicativo. Você pode escolher consultas SELECT que retornam linhas de dados (uma tabela de dados) ou consultas de SELECT que retornam um valor escalar (um único valor, como Count ou Sum).

Sobre o Escolher um tipo de consulta página, selecione o tipo de consulta para criar a lista de consultas disponíveis.

Dica

Criar uma instrução INSERT, UPDATE ou DELETE não substitui comandos do TableAdapter que são usados ao chamar o TableAdapter Update método. Por exemplo, selecionar UPDATE como um tipo de consulta criará uma nova consulta com um nome especificado posteriormente no assistente. Você executa essa consulta chamando isso de método nomeado do TableAdapter. Chamar o TableAdapter Update método executará instruções criadas quando o TableAdapter original foi configurado.

Especifique uma instrução SQL < tipo de consulta >

Sobre o especificar uma instrução SQL página, digite a instrução SQL para executar ao chamar a consulta.

Dica

O assistente fornece acesso para o Query Builder, uma ferramenta visual para criar consultas SQL. Para abri-lo, clique o Query Builder botão.

Escolha métodos para gerar

Esta página fornece opções para selecionar quais métodos o assistente gera para a consulta.

• Preencher uma DataTable
  Cria um método para preencher a tabela de dados. Passe o nome da tabela de dados como um parâmetro ao chamar esse método para preencher a tabela de dados com os dados retornados.

  Opcionalmente, você pode alterar o nome padrão no nome do método caixa. Fornecer um nome significativo pode ser útil ao trabalhar com esta consulta em código.

• Retornar uma DataTable
  Cria um método para retornar uma tabela de dados preenchida. Em determinados aplicativos, pode ser mais desejável retornar uma tabela de dados preenchida ao invés de preencher a tabela de dados existente com dados.

  Opcionalmente, você pode alterar o nome padrão no nome do método caixa.

Escolha o nome da função

Digite um nome para a função. Criar uma consulta TableAdapter adiciona um método ao TableAdapter com o nome fornecido aqui. Chame esse método para executar a consulta. Fornecer um nome significativo é útil ao trabalhar com esta consulta em código.

Dica

Ao criar novos procedimentos armazenados, você precisará fornecer dois nomes. O nome é o nome do procedimento armazenado criado no banco de dados; o segundo nome é o nome do método no TableAdapter que executa o procedimento armazenado quando chamado.

Criar novos procedimentos armazenados

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

1. No gerar os procedimentos armazenados página, digite a instrução SQL para executar ao chamar o procedimento armazenado.

   Dica

   O assistente fornece acesso para o Query Builder, uma ferramenta visual para criar consultas SQL. Para abri-lo, clique o Query Builder botão.

2. No criar os procedimentos armazenados página, 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.

      Dica

      A capacidade de criar um procedimento armazenado no banco de dados é determinada pelas configurações de segurança para o banco de dados específico.

   O Visualizar resultados do assistente página mostra os resultados de criar a consulta do TableAdapter. Se o assistente encontrar problemas, esta página fornece as informações de erro.

Usar procedimentos armazenados existentes

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

1. Selecione um procedimento armazenado existente na lista suspensa no Escolha um procedimento armazenado existente página do assistente.

   O parâmetros e resultados armazenado selecionado procedimento são exibidos para referência.

2. Clique em Avançar.

Escolha o formato dos dados retornados pelo procedimento armazenado

O tipo dos dados retornados pelo procedimento armazenado selecionado determina como o assistente cria os métodos do TableAdapter.

Selecione o tipo de dados retornados por essa consulta.

• Selecionando dados tabulares abre o Escolha métodos para gerar página (descrita anteriormente nesta página Ajuda), que permite que você especifique os tipos de métodos, nomes de método e suporte a paginação a ser criada.

• Selecionando um único valor cria um método que retorna um único valor digitado. Essa opção abre a Escolher nome de função página (descrita anteriormente nesta página Ajuda).

• Selecionando nenhum valor cria um método digitado que executa o procedimento armazenado e não espera nenhum dado a ser retornado. Essa opção abre a Escolher nome de função página (descrita anteriormente nesta página Ajuda).

Exibir resultados assistentes

O Visualizar resultados do assistente página mostra os resultados de criar a consulta do TableAdapter. Se o assistente encontrar problemas, os detalhes são exibidos nesta página.

Consulte também

Visão geral de TableAdapter
Como editar consultas TableAdapter
Instruções passo a passo de dados
Associar controles dos Windows Forms a dados no Visual Studio
Visão geral de aplicativos de dados no Visual Studio
Conectando a dados no Visual Studio
Preparando o aplicativo para receber dados
Buscando dados no aplicativo
Associar controles a dados no Visual Studio
Editando dados no aplicativo
Validando dados
Salvando dados