TableAdapter Assistente de Configuração de Consulta
O Assistente de Configuração de Consulta do TableAdapter ajuda a criar e editar as consultas adicionais que podem ser adicionadas a TableAdapters. Uma consulta do TableAdapter é qualquer consulta SQL válida ou procedimento armazenado que retorna dados conforme o mesmo esquema que a tabela de dados associados do TableAdapter (ou que retorna um valor escalar). Após concluir o assistente, um método é adicionado ao TableAdapter que, quando chamado, executa a consulta. (Por exemplo, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)
Executando o assistente
Arraste consultas para o Designer de Conjunto de Dados ou configure consultas existentes (qualquer consulta listada após a primeira consulta).
A primeira consulta em um TableAdapter é a consulta principal do TableAdapter. Editar essa consulta principal abre o Assistente de Configuração do TableAdapter e edita o esquema da tabela de dados do TableAdapter. Todas as consultas listadas após a 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 a execução do assistente, consulte Como iniciar o Assistente de Configuração de Consulta do TableAdapter.
Escolha a 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 com o banco de dados.
Ao concluir a caixa de diálogo Propriedades da Conexão, a área Detalhes da Conexão exibe informações somente leitura sobre o provedor selecionado, bem como a cadeia de caracteres 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 caracteres de conexão no arquivo de configuração do aplicativo simplifica o processo de manutenção do aplicativo se a conexão com o banco de dados for alterada. Em caso de alteração na conexão com o banco de dados, é possível editar a cadeia de caracteres de conexão no arquivo de configuração do aplicativo. Dessa maneira, não será necessário editar o código-fonte e recompilar o aplicativo. Para obter informações sobre a edição de uma cadeia de caracteres de conexão no arquivo de configuração do aplicativo, consulte Como salvar e editar cadeias de conexão.
.gif "Observação de segurança") Observação de segurança |
|---|
As informações são armazenadas no arquivo de configuração do aplicativo como texto simples.Para reduzir a possibilidade de acesso não autorizado a informações confidenciais, é possível criptografar os 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 a opção Usar instruções SQL.
Escolha um Tipo de Consulta
O assistente cria vários tipos de consultas dependendo dos requisitos do aplicativo. É possível 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 Escolha um Tipo de Consulta, selecione o tipo de consulta que será criada na lista de consultas disponíveis.
Dica
Criar uma instruçã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 tipo de consulta criará uma nova consulta com um nome especificado posteriormente no assistente.Essa consulta é executada ao chamar esse método nomeado do TableAdapter.Chamar o método Update de um TableAdapter executará instruções criadas quando o TableAdapter original foi configurado.
Especifique uma Instrução SQL <Query Type>
Na página Especifique uma Instrução SQL, digite a instrução SQL que será executada ao chamar a consulta.
Dica
O assistente fornece acesso ao Query Builder, uma ferramenta visual para criar consultas SQL.Para abrir, clique no botão Query Builder.
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. O nome da tabela de dados é passado como um parâmetro ao chamar esse método para preencher a tabela de dados com os dados retornados.Opcionalmente, é possível alterar o nome padrão na caixa Nome do Método. Pode ser útil fornecer um nome significativo ao trabalhar com essa consulta em código.
Retornar uma DataTable
Cria um método para retornar uma tabela de dados preenchida. Em determinados aplicativos, pode ser mais vantajoso retornar uma tabela de dados preenchida ao invés de preencher a tabela de dados existente com dados.Opcionalmente, é possível alterar o nome padrão na caixa Nome do Método.
Escolha o Nome da Função
Digite um nome para a função. Criar uma consulta do TableAdapter adiciona um método ao TableAdapter com o nome fornecido aqui. Chame esse método para executar a consulta. É útil fornecer um nome significativo ao trabalhar com essa consulta em código.
Dica
Ao criar novos procedimentos armazenados, são solicitados 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.
Criar novos procedimentos armazenados
Esta seção explica como concluir o Assistente de Configuração de Consulta do TableAdapter ao selecionar a opção Criar novos procedimentos armazenados.
Na página Gerar os Procedimentos Armazenados, digite a instrução SQL que será executada ao chamar o procedimento armazenado.
Dica
O assistente fornece acesso ao Query Builder, uma ferramenta visual para criar consultas SQL.Para abrir, clique no botão Query Builder.
Na página Criar os Procedimentos Armazenados, faça o seguinte:
Digite um nome para o novo procedimento armazenado.
Especifique se o procedimento armazenado será criado no banco de dados subjacente.
Dica
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 Visualizar resultados do assistente mostra os resultados da criação da consulta do TableAdapter. Se o assistente encontrar problemas, esta página fornecerá as informações sobre o erro.
Usar procedimentos armazenados existentes
Esta seção explica como concluir o Assistente de Configuração de Consulta do TableAdapter ao selecionar a opção Usar procedimentos armazenados existentes.
Selecione um procedimento armazenado na lista suspensa na página Escolha um procedimento armazenado existente do assistente.
Os Parâmetros e Resultados do procedimento armazenado selecionado são exibidos para referência.
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 dos dados retornados por esta consulta.
Selecionar Dados Tabulares abre a página Escolha Métodos para Geração (descrita anteriormente nesta página de Ajuda), que permite especificar os tipos de métodos, os nomes de métodos e o suporte de paginação que serão criados.
Selecionar Um valor único cria um método tipado que retorna um valor único. Essa opção abre a página Escolha o Nome da Função (descrita anteriormente nesta página de Ajuda).
Selecionar Nenhum valor cria um método tipado que executa o procedimento armazenado e espera que nenhum dado seja retornado. Essa opção abre a página Escolha o Nome da Função (descrita anteriormente nesta página de Ajuda).
Visualizar resultados do Assistente
A página Visualizar resultados do assistente mostra os resultados da criação da consulta do TableAdapter. Se o assistente encontrar problemas, os detalhes serão exibidos nesta página.
Consulte também
Tarefas
Como editar consultas TableAdapter
Conceitos
Associando controles dos Windows Forms a dados no Visual Studio
Preparando o aplicativo para receber dados
Associando controles a dados no Visual Studio
Outros recursos
Instruções passo a passo de dados