Criar e configurar TableAdapters

 

Publicado: agosto de 2016

TableAdapters fornecem comunicação entre seu aplicativo e um banco de dados. Conectar-se ao banco de dados, executa consultas ou procedimentos armazenados, e retornam novos dados de tabela ou preenchimento existente DataTable com os dados retornados. TableAdapters também pode enviar dados atualizados do seu aplicativo de volta para o banco de dados.

TableAdapters são criados para você quando você executa uma das seguintes ações:

• Executando o Assistente para Configuração da Fonte de Dados, selecionando o banco de dados ou Web Service tipo de fonte de dados.

• Arrastando objetos de banco de dados da Server Explorer até o Dataset Designer.

Você pode criar um novo TableAdapter e configurá-lo com uma fonte de dados arrastando um adaptador de tabela da caixa de ferramentas para uma área vazia na superfície do Designer de conjunto de dados.

Para obter uma introdução a TableAdapters, consulte Preencher datasets usando TableAdapters.

Dica

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizando o IDE.

Usando o Assistente de configuração do TableAdapter

Execute o Assistente para criar ou editar TableAdapters e seus DataTables associados. Você pode configurar TableAdapters existentes clicando no Dataset Designer.

Se você arrastar um novo adaptador de tabela da caixa de ferramentas quando o Designer de conjunto de dados estiver em foco, o assistente solicitará que você especifique qual fonte de dados que o adaptador deve se conectar a e que tipo de comandos que o adaptador deve usar para se comunicar com o banco de dados, instruções SQL ou procedimentos armazenados. Você não verá essa opção se você estiver configurando um adaptador que já está associado uma fonte de dados.

• O criar métodos para enviar atualizações diretamente para o banco de dados opção é equivalente a definir a propriedade GenerateDBDirectMethods como verdadeira. A opção não está disponível quando a instrução SQL original não fornecer informações suficientes ou a consulta não é uma consulta atualizável. Essa situação pode ocorrer, por exemplo, em consultas JOIN e consultas que retornam um valor único (escalar).

• Se você optar por criar um novo procedimento armazenado, você pode especificar para criá-lo no banco de dados subjacente, dependendo da configurações de segurança e permissões para o banco de dados específico. Se você não tiver permissão para criar novos procedimentos armazenados no banco de dados, essa opção não pode ser concluída.

• Você também pode escolher procedimentos armazenados existentes para executar para o Selecione, Inserir, atualização, e Excluir comandos do TableAdapter. O procedimento armazenado atribuído para o atualização comando, por exemplo, é executado quando o TableAdapter.Update() método é 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 para o CompanyName conjunto de colunas na tabela, o coluna de origem do @CompanyName parâmetro para CompanyName.

  Dica

  O procedimento armazenado atribuído ao comando SELECT é executado chamando 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). Substituir Fill com o nome que você atribui se você alterá-lo do padrão de Preencher, e substitua "TableAdapter" com o nome real do TableAdapter (por exemplo, CustomersTableAdapter).

• Permitem que você gerar instruções INSERT, UPDATE e DELETE com base na instrução SELECT definida em Opções avançadas do Assistente de Gerar instruções SQL página, usar a simultaneidade otimista e especificar se para atualizar a tabela de dados após a inserção e atualização instruções são executadas.

Configurando o método Fill do TableAdapter

À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.

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.

Para adicionar uma consulta global a um TableAdapter

• Consultas globais são consultas SQL que retornam um valor único (escalar) ou nenhum valor. Normalmente, funções globais executam operações de banco de dados como inserções, atualizações, exclusões e agregar informação, como retornar uma contagem de clientes em uma tabela ou o total de cobranças para todos os itens em uma ordem específica.

  Adicionar consultas globais arrastando um consulta do DataSet guia do Toolbox em uma área vazia do Dataset Designer.

• Fornece uma consulta que realiza a tarefa desejada, por exemplo, SELECT COUNT(*) AS CustomerCount FROM Customers.

  Dica

  Arrastar uma consulta diretamente para o Dataset Designer cria um método que só retornará um valor escalar (único). Enquanto a consulta ou o procedimento armazenado que você selecionar pode retornar mais de um único valor, o método criado pelo assistente retornará apenas um único valor. Por exemplo, a consulta pode retornar a primeira coluna da primeira linha dos dados retornados.

Consulte também

Preencher datasets usando TableAdapters