Esporta (0) Stampa
Espandi tutto

Metodo DataSet.Load

Aggiornamento: novembre 2007

Riempie una classe DataSet con valori di un'origine dati utilizzando l'interfaccia IDataReader fornita.

  NomeDescrizione
yab24tfx.pubmethod(it-it,VS.90).gif yab24tfx.CFW(it-it,VS.90).gif yab24tfx.xna(it-it,VS.90).gif Load(IDataReader, LoadOption, DataTable[]) Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita, tramite una matrice di istanze della classe DataTable, per fornire informazioni relative allo schema e allo spazio dei nomi.
yab24tfx.pubmethod(it-it,VS.90).gif yab24tfx.CFW(it-it,VS.90).gif yab24tfx.xna(it-it,VS.90).gif Load(IDataReader, LoadOption, String[]) Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita e una matrice di stringhe, per rendere disponibili i nomi delle tabelle all'interno della classe DataSet.
yab24tfx.pubmethod(it-it,VS.90).gif yab24tfx.CFW(it-it,VS.90).gif yab24tfx.xna(it-it,VS.90).gif Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita, tramite una matrice di istanze della classe DataTable, per fornire informazioni relative allo schema e allo spazio dei nomi.
In alto

Il metodo Load fornisce una tecnica per riempire una singola classe DataTable con dati, recuperati da un'istanza IDataReader. Questo metodo fornisce la stessa funzionalità, ma consente di caricare più gruppi di risultati da un'interfaccia IDataReader in più tabelle all'interno di una classe DataSet.

Se DataSet contiene già righe, i dati in arrivo dall'origine dati vengono uniti alle righe esistenti.

Il metodo Load può essere utilizzato in diversi scenari comuni, tutti incentrati sull'ottenimento di dati da un'origine dati specificata e sull'aggiunta degli stessi al contenitore di dati corrente, in questo caso una classe DataSet. Questi scenari descrivono l'utilizzo standard per una classe DataSet, precisandone il comportamento per quanto riguarda aggiornamento e unione.

Una classe DataSet esegue la sincronizzazione o l'aggiornamento con un'origine dati primaria. La classe DataSet registra le modifiche, consentendo la sincronizzazione con l'origine dati primaria. Inoltre, una classe DataSet è in grado di accettare dati incrementali da una o più origini dati secondarie. DataSet non è responsabile per la registrazione delle modifiche allo scopo di consentire la sincronizzazione con l'origine dati secondaria.

Supponendo l'esistenza di due origini dati, un utente dovrà affidarsi probabilmente a uno dei due comportamenti seguenti:

  • Inizializzare DataSet da un'origine dati primaria. In questo scenario, l'utente intende inizializzare una classe DataSet vuota con valori dall'origine dati primaria. Vengono modificati uno o più contenuti di DataTable. In un secondo momento propagherà le modifiche nuovamente all'origine dati primaria.

  • Conservare le modifiche ed eseguire nuovamente la sincronizzazione dall'origine dati primaria. In questo scenario, l'utente intende utilizzare la classe DataSet riempita nello scenario precedente ed eseguire una sincronizzazione incrementale con l'origine dati primaria, conservando le modifiche apportate nella classe DataSet.

  • Inserire dati incrementali da origini dati secondarie. In questo scenario, l'utente desidera unire le modifiche da una o più origini dati secondarie e propagare nuovamente tali modifiche all'origine dati primaria.

Il metodo Load rende possibili tutti gli scenari descritti sopra. Questo metodo consente di specificare un parametro per l'opzione di caricamento, che indica la modalità con cui le righe che già si trovano in una classe DataTable vengono combinate con le righe che vengono caricate. Nella tabella riportata di seguito vengono descritte le tre opzioni di caricamento fornite dall'enumerazione LoadOption. In ogni caso, la descrizione indica il comportamento quando la chiave primaria di una riga nei dati in entrata corrisponde alla chiave primaria di una riga esistente.

Opzione di caricamento

Descrizione

PreserveChanges (predefinito)

Aggiorna la versione originale della riga con il valore della riga in entrata.

OverwriteChanges

Aggiorna la versione originale e la versione corrente della riga con il valore della riga in entrata.

Upsert

Aggiorna la versione corrente della riga con il valore della riga in entrata.

In generale, le opzioni PreserveChanges e OverwriteChanges sono indicate per scenari in cui l'utente ha necessità di sincronizzare la classe DataSet e le rispettive modifiche con l'origine dati primaria. L'opzione Upsert semplifica le modifiche di aggregazione da una o più origini dati secondarie.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft