Caixa de Diálogo Data Adapter Preview

Permite que você consulte como serão os dados preenchidos em um DataSet quando um adaptador de objeto SelectCommand é chamado.Usar essa caixa de diálogo permite-lhe testar se o adaptador está retornando os dados esperados, se qualquer mapeamento de tabela funciona corretamente, e que não existem erros quando você preencher o DataSet.A caixa de diálogo também permite você testar o efeito de passar valores de parâmetros diferentes para o adaptador.

Observação:

Na versão anterior do Visual Studio, adaptadores de dados eram usados para comunicação entre um aplicativo e um banco de dados. Enquanto adaptadores de dados são ainda um componente principal do .NET Framework Providers Dados, TableAdapters são componentes gerados pelo designer que simplificam o processo de manipular dados entre seu aplicativo e um banco de dados.Para obter mais informações sobre como trabalhar com TableAdapters, consulte Visão geral do TableAdapter.

Visualizar um adaptador de dados é particularmente útil se você for para usá-lo para preencher um DataSet que não foi gerado diretamente para o adaptador.

A caixa de diálogo aparece quando você executar uma das seguintes ações:

• Selecione Preview Data a partir do menu Data.Este menu está disponível somente quando um adaptador de dados foi adicionado à um formulário ou componente.

• Clique no link Preview Data na parte inferior da janela Properties.Este link está disponível quando você está exibindo propriedades para um adaptador de dados.

Lista User Interface Element

• Adaptadores de dados
  Lista os adaptadores de dados disponíveis no formulário ou componente que você estiver trabalhando.Selecione o adaptador que você deseja visualizar.Para mostrar os resultados do uso de todos os adaptadores de dados, selecione <All data adapters>.

• Preencher DataSet
  Executa o comando e exibir os dados na caixa Results.

  Se ocorrer um erro enquanto o adaptador de dados estiver preenchendo dados para o DataSet, o erro é exibido em uma caixa de mensagem.Possíveis erros incluem:

  • Tipos de dados incompatíveis

  • Erros de sintaxe na Instrução SQL ou stored procedure sendo executado.

  • Tabela de mapeamento de erros.Por exemplo, se um MissingMappingAction de adaptador ou propriedades MissingSchemaAction são definidas como Error,e os mapeamentos de tabela não completamente descrevem o que fazer com nomes de coluna incompatível no banco de dados e DataSet, um erro é gerado.

  • Problemas de conexão.

• Parâmetros
  Exibe parâmetros necessários para a declaração SELECT do SQL ou o procedimento armazenado mencionado no objeto SelectCommand do adaptador ou adaptadores de dados especificados.Se nenhum parâmetro for obrigatório, essa grade estará em branco.

  Cada parâmetro é exibido como uma linha na grade com o nome do parâmetro e o tipo de dado.Entre como um valor para cada parâmetro na caixa Value.Como alternativa, se o parâmetro aceitar isso, você pode selecionar <DEFAULT> ou <NULL> da lista suspensa na caixa Value.

• DataSet destino
  Especifica o DataSet no qual o comando visualização deve preencher dados.Você pode selecionar dentre todos os DataSets disponíveis em seu projeto ou pode selecionar para preencher um DataSet sem-tipo (sem um esquema).

• Tabelas de dados
  Exibe uma lista das tabelas de dados no DataSet.Selecione um nome de tabela para ver os registros preenchidos pelo adaptador de dados.(Normalmente, cada adaptador de dados preenche uma tabela no DataSet.) Se tiver mais de uma tabela preenchida, selecione uma tabela contida nesta lista para ver os resultados para aquela tabela.

• Resultados
  Exibe os dados no DataSet.A caixa mostra como os dados serão exibidos após retornados a partir do banco de dados e após qualquer mapeamento de tabela terem sido aplicados.Os dados na grade são somente para leitura.

  Se houver mais de uma tabela nos resultados, poderá exibir o conteúdo de uma tabela específica, selecionando o nome na lista Data table.

• Limpar os resultados
  Limpa todos os dados na tabela selecionada.Para limpar todas as tabelas, selecione cada uma na lista Data tables e clique em Clear Results para cada um.

Consulte também

Conceitos

Introdução a adaptadores de dados

Exibindo visão geral de dados

Outros recursos

Criando adaptadores de dados

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Exibindo dados em formulários em aplicativos do Windows

Editar dados no seu aplicativo

Validando Dados

Salvando dados