Criar e configurar TableAdapters em aplicativos do .NET Framework

Os TableAdapters habilitam a comunicação entre seu aplicativo e um banco de dados. Eles se conectam ao banco de dados, executam consultas ou procedimentos armazenados e retornam uma nova tabela de dados ou preenchem uma instância de classe existente DataTable com os dados retornados. TableAdapters também pode enviar dados atualizados do aplicativo de volta para o banco de dados.

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

• Arraste objetos de banco de dados do Gerenciador de Servidores para o Designer de Conjunto de Dados.

• Arraste o TableAdapter objeto da Caixa de Ferramentas para uma região vazia na superfície do Designer do Conjunto de Dados e configure a fonte de dados.

• Execute o Assistente de Configuração da Fonte de Dados e selecione o tipo de fonte de dados banco de dados ou serviço Web :

  

Para obter uma introdução ao TableAdapters, consulte Preencher conjuntos de dados usando TableAdapters.

Pré-requisitos

Para concluir os procedimentos neste artigo, os seguintes pré-requisitos devem ser atendidos:

• Visual Studio. Baixe o Visual Studio agora.

Acessar o Assistente de Configuração do TableAdapter

Você pode usar o Assistente de Configuração tableAdapter para criar novos TableAdapters ou editar instâncias existentes e configurar suas tabelas de dados associadas.

• Para configurar um TableAdapter existente com o assistente, clique com o botão direito do mouse na instância tableAdapter no Designer de Conjunto de Dados e selecione Configurar:

  

• Para criar um novo TableAdapter com o assistente, arraste o objeto TableAdapter da Caixa de Ferramentas para uma região vazia na superfície do Designer do Conjunto de Dados.

Use o assistente

Para a configuração do TableAdapter, o Assistente de Configuração do TableAdapter orienta você pelas seguintes tarefas:

1. Defina as configurações necessárias para o TableAdapter.

   • Especifique o tipo de fonte de dados para a conexão TableAdapter.

   • Identifique os comandos a serem usados para comunicação com o banco de dados, instruções SQL ou procedimentos armazenados. Se o TableAdapter já estiver associado a uma fonte de dados, você não verá essa opção no assistente.

2. Crie procedimentos armazenados, conforme necessário.

   Crie um novo procedimento armazenado no banco de dados subjacente, se você tiver as permissões corretas para o banco de dados. Se você não tiver as permissões necessárias, essa opção não estará disponível no assistente.

3. Execute os procedimentos armazenados existentes, conforme necessário.

   Os procedimentos estão disponíveis para os comandos SELECT, INSERT, UPDATE e DELETE do TableAdapter. Por exemplo, o procedimento armazenado atribuído ao comando UPDATE é executado quando você chama o TableAdapter.Update() método.

4. Mapeie parâmetros do procedimento armazenado selecionado para as colunas correspondentes na tabela de dados. Por exemplo, se o procedimento armazenado aceitar um parâmetro chamado @CompanyName e o passa para a coluna CompanyName da tabela de dados, defina a Coluna de Origem do parâmetro @CompanyName como CompanyName.

   Observação

   Para o comando SELECT , o procedimento armazenado é executado quando você chama o método TableAdapter Fill , por padrão. Especifique um nome para o método Fill() na próxima página do assistente. Quando você usa o método padrão, o código típico para executar o procedimento armazenado para o comando SELECT é TableAdapter.Fill(<TableName>). Substitua a <TableName> parte pelo nome da tabela de dados.

   Se você alterar o nome do método padrão de Fill, será necessário atualizar o código do procedimento. Substitua Fill pelo novo nome do método e use o nome real do TableAdapter. Por exemplo, para um TableAdapter nomeado CustomersTableAdapter e uma tabela de dados chamada CustomersTable, se você alterar o nome do Fill método para AddData, atualize o código para CustomersTableAdapter.AddData(CustomersTable).

   • Escolha se deseja habilitar os métodos Create para enviar atualizações diretamente para a opção de banco de dados . Quando essa opção está habilitada, é equivalente a definir a GenerateDBDirectMethods propriedade como true. A opção não está disponível quando a instrução SQL original não fornece informações suficientes ou a consulta não é uma consulta atualizável. Por exemplo, quando consultas do tipo JOIN e outras consultas retornam apenas um valor escalar.

5. Configure suas preferências para as Opções Avançadas.

   • Gere comandos INSERT, UPDATE e DELETE com base no comando SELECT definido na página Gerar instruções SQL .

   • Use concorrência otimista.

   • Atualize a tabela de dados após a execução dos comandos INSERT e UPDATE .

Configurar o método TableAdapter.Fill()

Em alguns cenários, talvez você queira alterar o esquema da tabela de dados do TableAdapter. Para concluir a ação, modifique o método primário Fill do TableAdapter. TableAdapters são criados com um método primário Fill que define o esquema da tabela de dados associada. O método primário Fill baseia-se na consulta ou no procedimento armazenado que você inseriu quando configurou originalmente o TableAdapter. É o primeiro método (mais alto) na tabela de dados no Dataset Designer.

Todas as alterações feitas no método principal Fill do TableAdapter são refletidas no esquema da tabela de dados associada. Por exemplo, remover uma coluna da consulta no método principal Fill também remove a coluna da tabela de dados associada. Além disso, remover a coluna do método principal Fill remove a coluna de quaisquer consultas adicionais para esse TableAdapter.

Você pode usar o Assistente de Configuração de Consulta tableAdapter para criar e editar consultas adicionais para o TableAdapter. Essas consultas adicionais devem estar em conformidade com o esquema de tabela, a menos que retornem um valor escalar. Cada consulta adicional tem um nome que você especifica.

O exemplo a seguir mostra como chamar uma consulta adicional chamada FillByCity:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

Criar consulta com o assistente

Você pode criar uma nova consulta com o Assistente de Configuração de Consulta TableAdapter seguindo estas etapas:

1. Abra seu conjunto de dados no Designer de Conjunto de Dados .

2. Crie uma nova consulta com uma das seguintes ações:

   • No Designer de Conjunto de Dados, clique com o botão direito do mouse no TableAdapter e selecione Adicionar Consulta.
   • Arraste o objeto Query da guia Conjunto de Dados da Caixa de Ferramentas para um DataTable na superfície do Designer do Conjunto de Dados.
   • Arraste o objeto Query da Caixa de Ferramentas para uma área vazia na superfície do Designer do Conjunto de Dados; isso criará um TableAdapter sem uma associação com DataTable.

   Essas consultas podem retornar apenas valores únicos (escalares) ou executar comandos UPDATE, INSERT ou DELETE no banco de dados.

3. Na tela Escolher Sua Conexão de Dados , selecione uma conexão existente ou crie uma nova conexão para a consulta.

   Observação

   Essa tela aparece somente quando o designer não pode determinar a conexão a ser usada ou quando nenhuma conexão está disponível.

4. Na tela Escolher um Tipo de Comando , configure o comando selecionando os seguintes métodos que buscam dados do banco de dados:

   • Usar instruções SQL: permite digitar uma instrução SQL para selecionar os dados do banco de dados.

   • Crie um novo procedimento armazenado: o assistente cria um novo procedimento armazenado (no banco de dados) com base no comando SELECT especificado.

   • Use procedimentos armazenados existentes: execute um procedimento armazenado existente ao executar a consulta.

Configurar uma consulta com o assistente

Para editar uma consulta TableAdapter existente com o Assistente de Configuração de Consulta TableAdapter, clique com o botão direito do mouse na consulta e selecione Configurar. A ação de clique com o botão direito do mouse produz um resultado diferente, dependendo de qual tipo de consulta você selecionar:

• Para a consulta principal de um TableAdapter, o TableAdapter e o esquema DataTable são reconfigurados.

• Em uma consulta adicional em um TableAdapter, somente a consulta selecionada é reconfigurada.

O Assistente de Configuração do TableAdapter reconfigura a definição tableAdapter, enquanto o Assistente de Configuração de Consulta tableAdapter reconfigura apenas a consulta selecionada.

Adicionar uma consulta global a um TableAdapter

Consultas globais são consultas SQL que retornam um único valor (escalar) ou nenhum valor. Normalmente, as funções globais executam operações de banco de dados, como inserções, atualizações e exclusões. Eles também agregam informações, como uma contagem de clientes em uma tabela ou o total de encargos para todos os itens em uma determinada ordem.

1. Adicione uma consulta global arrastando o objeto Query da guia Conjunto de Dados da Caixa de Ferramentas para uma região vazia na superfície do Designer do Conjunto de Dados.

2. Insira uma consulta que execute uma tarefa específica, como SELECT COUNT(*) AS CustomerCount FROM Customers.

   Observação

   Arrastar um Query objeto diretamente para a superfície do Designer de Conjunto de Dados cria um método que retorna apenas um valor escalar (único). Embora a consulta ou o procedimento armazenado selecionado possa retornar mais de um único valor, o método criado pelo assistente retorna apenas um único valor. Por exemplo, a consulta pode retornar a primeira coluna da primeira linha dos dados retornados.

Conteúdo relacionado

• preencha conjuntos de dados usando TableAdapters
• Classe DataTable
• Classe DataSet