Procedura: eseguire il mapping delle colonne dell'origine dati alle colonne delle tabelle dati di un dataset

Articolo
09/12/2008

Aggiornamento: novembre 2007

La creazione di un mapping in un adattatore dati consente di stabilire una corrispondenza tra le colonne nell'origine dati e le colonne in una tabella del dataset. Per ulteriori informazioni, vedere Mapping di tabelle negli adattatori dati.

Nota:
Nella versione precedente di Visual Studio per le comunicazioni tra un'applicazione e un database venivano utilizzati degli adattatori dati. Mentre gli adattatori dati sono comunque un componente essenziale dei .Provider di dati .NET Framework (ADO.NET), gli oggetti TableAdapter sono componenti generati dalla finestra di progettazione che consentono di semplificare il processo di spostamento dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter.

Nella versione precedente di Visual Studio per le comunicazioni tra un'applicazione e un database venivano utilizzati degli adattatori dati. Mentre gli adattatori dati sono comunque un componente essenziale dei .Provider di dati .NET Framework (ADO.NET), gli oggetti TableAdapter sono componenti generati dalla finestra di progettazione che consentono di semplificare il processo di spostamento dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter.

Per associare le colonne dell'origine dati a una tabella del dataset

Creare un adattatore dati. Per ulteriori informazioni, vedere Creazione di adattatori dati.
In un form o nella finestra di progettazione componenti selezionare l'adattatore dati, quindi visualizzare la finestra Proprietà.
Accanto alla proprietà TableMappings fare clic sul pulsante con i puntini di sospensione (....). Verrà visualizzata la finestra di dialogo Mapping tabelle.

Se si desidera associare i nomi delle colonne dell'origine dati a un dataset esistente, selezionare Usa un DataSet per suggerire nomi di colonne e tabelle, quindi selezionare un dataset dall'elenco DataSet.

Le tabelle disponibili nel dataset selezionato vengono riportate nell'elenco Tabella DataSet, mentre le colonne della prima tabella del dataset vengono inserite nella parte destra della griglia Mapping colonne.

Nota:
La selezione di un dataset risulta utile poiché consente l'impostazione dei valori predefiniti per le colonne del dataset di destinazione del mapping nella finestra di dialogo Mapping. Il dataset non fa parte delle informazioni gestite per i mapping nell'adattatore. È inoltre possibile utilizzare gli stessi mapping con più dataset.

In Tabella di origine selezionare la tabella nell'origine dati da associare. Se nel dataset è disponibile una sola tabella, il valore predefinito sarà Tabella.
In Tabella Dataset selezionare la tabella nel dataset di cui eseguire il mapping. Se è già stato selezionato un dataset di cui eseguire il mapping nel passaggio 3, sarà già stato fornito un nome. Per impostazione predefinita, la prima tabella nel dataset viene definita Table.

I valori negli elenchi Colonne di origine e Colonne del DataSet vengono inseriti in base alle scelte effettuate o alle impostazioni predefinite. La griglia indica la modalità con cui verrà eseguito il mapping: ciascuna colonna nella colonna di sinistra verrà associata alla colonna corrispondente nella colonna di destra.
Modificare i mapping in base alle necessità. Tale operazione può comportare:
- La selezione di colonne differenti negli elenchi delle colonne dell'origine dati o del dataset per modificare il mapping tra le colonne.
- La rimozione di colonne dal mapping. Questa operazione potrebbe essere necessaria nel caso in cui l'adattatore restituisca un numero di colonne dell'origine dati maggiore rispetto a quello necessario.
- L'aggiunta di colonne. Questa operazione potrebbe essere necessaria se si è certi che in fase di esecuzione saranno disponibili le colonne non rappresentate in fase di progettazione o se è stata eliminata una colonna e si desidera ripristinarla o se è stata definita in modo più preciso la query dell'adattatore e si desidera modificare i mapping.
Una volta modificati i mapping, scegliere OK.

Se si desidera specificare la modalità di gestione di eventuali condizioni di errore, nella finestra Proprietà selezionare le opzioni per le proprietà MissingMappingAction e MissingSchemaAction. Nella tabella riportata di seguito vengono elencate alcune delle impostazioni più comuni e i relativi effetti.

MissingMappingAction	MissingSchemaAction	Effetto
Passthrough	Add oppure AddWithKey	Se una colonna esiste nell'origine ma non nello schema e non esiste alcun mapping per essa, la colonna verrà creata quando il dataset viene riempito. Si tratta dell'impostazione predefinita e risulta utile quando si desidera semplicemente copiare nel dataset tutte le colonne disponibili nell'origine.
Ignore	Ignore	Se la colonna non viene definita nello schema del dataset o se non esiste alcun mapping per essa, le informazioni dell'origine non verranno copiate nel dataset. Questa impostazione risulta utile se l'adattatore restituisce più informazioni di quelle che si desidera inserire nel dataset.
Error	Error	Se l'adattatore non è in grado di associare una colonna dell'origine a una colonna del dataset poiché il mapping non è presente o perché lo schema del dataset non contiene la colonna, verrà generato un errore in fase di esecuzione. Questa impostazione risulta utile quando si utilizza uno schema definito in modo rigoroso e si desidera essere certi che venga assegnato un flag a qualsiasi deviazione dallo schema.