Assistente de configuração da consulta TableAdapter

Artigo
08/01/2011

O TableAdapter Query Configuration Wizard ajuda a criar e editar as consultas adicionais que você pode adicionar ao TableAdapters. Uma consulta TableAdapter é qualquer consulta SQL válida ou procedimento armazenado que retorna dados de acordo com o mesmo esquema que a Tabela de dados associada do TableAdapter (ou que retorna um valor escalar). Depois que você conclui o assistente, um método é adicionado ao TableAdapter que, quando chamado, executa a consulta. (Por exemplo, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

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 TableAdapter Configuration Wizard 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 TableAdapter Query Configuration Wizard. Para obter mais informações sobre executar o assistente, consulte Como: Iniciar o TableAdapter Query 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.

Use instruções SQL

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

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 SELECT que retornam um valor escalar (um único valor, como Count ou Sum).

Na página Choose a Query Type, selecione o tipo de consulta para criar a partir da lista de consultas disponíveis.

Observação
Criar uma declaração INSERT, UPDATE ou DELETE não substitui os comandos do TableAdapter que são usados ao chamar o método Update do TableAdapter. 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 método Update do TableAdapter executará instruções criadas quando o TableAdapter original foi configurado.

Criar uma declaração INSERT, UPDATE ou DELETE não substitui os comandos do TableAdapter que são usados ao chamar o método Update do TableAdapter. 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 método Update do TableAdapter executará instruções criadas quando o TableAdapter original foi configurado.

Especifique uma instrução SQL <Query Type>

Na página Specify a SQL Statement, digite o Instrução SQL para executar ao chamar a consulta.

Dica

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.

Escolha métodos para gerar

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

Preencher uma tabela de dados
Cria um método para preencher a tabela de dados. Você passa o nome da tabela de dados como um parâmetro quando chamar este método para preencher a tabela de dados com os dados retornados.

Opcionalmente, você pode alterar o nome padrão na caixa Method Name. Fornecer um nome significativo pode ser útil ao trabalhar com esta consulta em código.
Retornar uma tabela de dados
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 em oposição a preencher a tabela de dados existente com dados.

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

Nome da Função Escolha

Digite um nome para a função. Criar uma consulta TableAdapter adiciona um método para o 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.

Observação
Quando criar novos procedimentos armazenados lhe é perguntado por dois nomes. O primeiro 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.

Crie novos procedimentos armazenados

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

Na página Generate the Stored Procedures, digite a Instrução SQL para executar ao chamar o procedimento armazenado.

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:
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 de criar um procedimento armazenado no banco de dados é determinada pelas configurações de segurança do banco de dados específico.
A página View Wizard Results mostra os resultados de criar a consulta TableAdapter. Se o assistente encontrar problemas, esta página fornece as informações de erro.

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

Use procedimentos armazenados existentes

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

Selecione um procedimento armazenado existente na lista drop-down na página Choose an existing stored procedure do assistente.

O Parameters e Results para o procedimento armazenado selecionado são exibidos para referência.
Clique em Next.

Escolha a forma 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 dos dados retornados por essa consulta.

Selecionar Tabular data abre a página Choose Methods to Generate (descrita anteriormente nesta página Ajuda), que permite a você especificar os tipos de métodos, nomes de método, e suporte a paginação a ser criada.
Selecionar A single value cria um método que retorna um único valor digitado. Essa opção abre a páginaChoose Function Name (descrita anteriormente nesta página Ajuda).
Selecionar No value cria um método digitado que executa o procedimento armazenado e não espera nenhum dado a ser retornado. Essa opção abre a páginaChoose Function Name (descrita anteriormente nesta página Ajuda).

Exibir resultados assistentes

A página View Wizard Results mostra os resultados de criar a consulta TableAdapter. Se o assistente encontrar problemas, os detalhes são exibidos na página.

Consulte também

Compartilhar via