Como: Mapear dados-fonte Columns to Dataset dados-tabela Columns

Artigo
08/25/2010

Criar um mapeamento em um adaptador de dados permite que você estabeleça uma correspondência entre colunas na fonte de dados e colunas em uma tabela DataSet.Para obter mais informações, consulte Mapeamento de tabela em adaptadores de dados.

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

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

Como: mapear data-source columns para uma dataset table

Crie um adaptador de dados.Para obter mais informações, consulte Criando adaptadores de dados.
Em um formulário ou um componente designer, selecione o adaptador de dados e abra a janela Properties.
Próximo à propriedade TableMappings, clique no botão reticências (... ).A caixa de diálogo Table Mappings abre.

Se você desejar mapear nomes de colunas a partir da fonte de dados para um conjunto de dados existente, marque Use a Dataset to suggest table and column names e então selecione um conjunto de dados da lista Dataset.

As tabelas disponíveis nesse dataset estão listadas na lista Dataset table, e as colunas da primeira tabela no dataset são preenchidas no lado direito da gradeColumn mappings.

Observação:
Escolher um conjunto de dados é uma conveniência que permite que o MAP pings caixa de diálogo para estabelecer padrões para as colunas do conjunto de dados para MAP para.O conjunto de dados não é parte das informações mantidas para os mapeamentos no adaptador.Além disso, você pode usar os mesmos mapeamentos com mais de um dataset.

Abaixo de Source table, selecione a tabela na fonte de dados a mapear.Se houver apenas uma tabela no dataset, o valor padrão é Table.
Abaixo de Dataset table, selecione a tabela no dataset a mapear.Se você tiver selecionado um conjunto de dados para mapear na etapa 3, um nome já será preenchido.(Por padrão, a primeira tabela no conjunto de dados é chamada de Tabela.)

Com base em suas opções (ou os padrões), valores de Colunas de fonte and Dataset Columns listas são preenchidas.A grade indica como o mapeamento será executado: haverá correspondência de cada coluna na coluna da esquerda para a coluna correspondente na coluna à direita.
Ajuste os mapeamentos conforme necessário.Isso pode incluir:
- Selecionando colunas diferentes nas listas fonte ou coluna de dataset para alterar quais colunas mapeiam para quais.
- Removendo colunas do mapeamento.Você pode fazer isso se o adaptador está retornando mais colunas da fonte de dados de que você precisa.
- Adicionando colunas.Você pode fazer isso se você souber que colunas existirão no tempo de execução que não são representadas em tempo de design, ou se você tiver excluído uma coluna e agora a quer novamente, ou se você refinou a consulta do adaptador e agora precisa ajustar os mapeamentos.
Quando você tiver terminado de ajustar os mapeamentos, clique em OK.

Se você deseja especificar como manipular possíveis condições de erro, na janela Properties, selecione as opções para o MissingMappingAction e propriedades MissingSchemaAction.A tabela a seguir lista algumas configurações comuns e seus efeitos.

Falta ação de mapeamento	Faltando ação de esquema	Efeito
Passthrough	Add ou AddWithKey	Se uma coluna existe na fonte mas não no esquema e não houver nenhum mapeamento para ele, a coluna é criada quando o conjunto de dados é preenchido.Esta é a configuração padrão e é útil quando você deseja simplesmente copiar todas as colunas disponíveis na fonte para o conjunto de dados.
Ignore	Ignore	Se a coluna não está definida no esquema do dataset, ou se não há mapeamento para ele, informações não são copiadas da fonte para o conjunto de dados.Essa configuração é útil se o adaptador retornar mais informações do que você deseja no dataset.
Error	Error	Um erro em tempo de execução é gerado se o adaptador não pode mapear uma coluna de origem para uma coluna do dataset porque o mapeamento está faltando ou porque o esquema do dataset não contém a coluna.Essa configuração é útil quando você estiver trabalhando com um esquema rigorosamente definido e quer ter certeza de que quaisquer desvios do esquema sejam sinalizados.