Finestra di dialogo Anteprima adattatore dati

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di vedere come verranno inseriti i dati nel dataset quando verrà richiamato l'oggetto SelectCommand dell'adattatore. Mediante questa finestra di dialogo è possibile verificare che l'adattatore restituisca i dati previsti, che i mapping delle tabelle funzionino correttamente e che non si verifichino errori durante la compilazione del dataset. La finestra di dialogo consente inoltre di determinare quale risultato si ottiene passando all'adattatore valori di parametri diversi.

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 modifica 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 modifica dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter.

La visualizzazione in anteprima per un adattatore dati risulta particolarmente utile se si intende utilizzarlo per compilare un dataset che non è stato generato direttamente dall'adattatore.

La finestra di dialogo viene visualizzata effettuando una delle operazioni seguenti:

Selezionare Anteprima dati dal menu Dati. Questo menu è disponibile soltanto se a un form o a un componente è stato aggiunto un adattatore dati.
Fare clic sul collegamento Anteprima dati nella parte inferiore della finestra Proprietà. Questo collegamento è disponibile quando si visualizzano le proprietà di un adattatore dati.

Elenco degli elementi dell'interfaccia utente

Adattatori dati
Qui vengono elencati gli adattatori dati disponibili per il form o il componente con cui si sta lavorando. Selezionare l'adattatore per cui si desidera visualizzare l'anteprima. Selezionare <Tutti gli adattatori dati> per visualizzare un'anteprima dei risultati ottenuti utilizzando tutti gli adattatori.
Riempi Dataset
Esegue il comando e visualizza i dati nella casella Risultati.

Eventuali errori che si verificano mentre i dati vengono inseriti nel dataset saranno visualizzati in una finestra di messaggio. Tra i possibili errori sono compresi:
- Tipo di dati non corrispondente.
- Errori di sintassi nella stored procedure o nell'istruzione SQL in esecuzione.
- Errori nei mapping delle tabelle. Se ad esempio le proprietà MissingMappingAction o MissingSchemaAction di un adattatore sono impostate su Error e i mapping delle tabelle non contengono informazioni dettagliate su come affrontare l'eventualità di nomi di colonna non corrispondenti nel database e nel dataset, viene generato un errore.
- Problemi di connessione.
Parametri
Consente di visualizzare i parametri necessari per la stored procedure o l'istruzione SQL SELECT a cui viene fatto riferimento nell'oggetto SelectCommand dell'adattatore o degli adattatori dati specificati. Se non sono necessari parametri, la griglia è vuota.

Ciascun parametro viene visualizzato su una riga della griglia con il relativo nome e il tipo di dati già indicati. Immettere un valore per ogni parametro nella casella Valore. In alternativa, se il parametro lo prevede, selezionare <PREDEFINITO> o <NULL> dall'elenco a discesa nella casella Valore.
Dataset di destinazione
Consente di specificare il dataset in cui il comando di visualizzazione in anteprima deve inserire i dati. È possibile scegliere un dataset fra tutti quelli disponibili nel progetto oppure selezionare un dataset non tipizzato, ovvero senza schema.
Tabelle dati
Consente di visualizzare l'elenco delle tabelle dati del dataset. Selezionare il nome di una tabella per visualizzare i relativi record compilati dall'adattatore dati. Di norma ciascun adattatore dati provvede a compilare una tabella del dataset. Qualora vengano riempite più tabelle, è possibile selezionare una delle tabelle dell'elenco per visualizzare i relativi risultati.
Risultati
Consente di visualizzare i dati contenuti nel dataset così come si presenteranno dopo essere stati restituiti dal database e dopo l'applicazione di tutti i mapping delle tabelle. I dati riportati nella griglia sono in sola lettura.

Se nei risultati sono riportate più tabelle, è possibile visualizzare il contenuto di ciascuna di esse selezionandone il nome dall'elenco Tabelle dati.
Cancella risultati
Consente di cancellare tutti i dati della tabella selezionata. Per cancellare tutte le tabelle, selezionarle una dopo l'altra nell'elenco Tabelle dati e fare clic su Cancella risultati per ciascuna.