Compilazione del set di dati di un provider gestito da un adattatore dati

Il set di dati è una rappresentazione residente in memoria dei dati che fornisce un modello di programmazione relazionale coerente indipendentemente dall'origine dati. Il set di dati rappresenta un set completo di dati, inclusi tabelle, vincoli e relazioni tra le tabelle. Poiché il set di dati è indipendente dall'origine dati, un set di dati può includere dati locali per l'applicazione e anche dati provenienti da più origini dati. L'interazione con le origini dati esistenti viene controllata tramite un MsDb2DataAdapter oggetto .

Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter.SelectCommand%2A?displayProperty=fullName è un Command oggetto che recupera i dati dall'origine dati. Le InsertCommandproprietà , UpdateCommande DeleteCommand di Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter sono anche Command oggetti che gestiscono gli aggiornamenti ai dati nell'origine dati in base alle modifiche apportate ai dati nel set di dati.

Fill, metodo

Il MsDb2DataAdapter.Fill metodo viene usato per popolare un set di dati con i risultati di Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter.SelectCommand%2A?displayProperty=fullName. Fill accetta come argomenti un DataSet oggetto da popolare e un DataTable oggetto oppure il nome dell'oggetto DataTable da riempire con le righe restituite da SelectCommand.

Il Fill metodo usa Microsoft.HostIntegration.MsDb2Client.MsDb2DataReader in modo implicito per restituire i nomi e i tipi di colonna usati per creare le tabelle nel set di dati e anche i dati per popolare le righe delle tabelle nel set di dati. Le tabelle e le colonne vengono create solo se non esistono già; in caso contrario Fill , usa lo schema del set di dati esistente. I tipi di colonna vengono creati come tipi .NET Framework. Le chiavi primarie non vengono create a meno che non si trovino nell'origine dati e DataAdapter.MissingSchemaAction siano impostate su MissingSchemaAction.AddWithKey. Se Fill rileva che esiste una chiave primaria per una tabella, sovrascrive i dati in DataSet con i dati dell'origine dati per le righe in cui i valori della colonna chiave primaria corrispondono a quelli della riga restituita dall'origine dati. Se non viene trovata alcuna chiave primaria, i dati vengono aggiunti alle tabelle nell'oggetto DataSet. Fill utilizzano eventuali mapping che possono esistere durante il popolamento dell'oggetto DataSet .

Nota

Se SelectCommand restituisce i risultati di un OUTER JOIN, non MsDb2DataAdapter imposta un valore PrimaryKey per l'oggetto risultante DataTable. È necessario definire personalmente PrimaryKey per assicurarsi che le righe duplicate vengano risolte correttamente

Più set di risultati

Se Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter rileva più set di risultati, crea più tabelle nel set di dati. Alle tabelle viene assegnato il nome predefinito incrementale TableN, che inizia con "Table" per Table0. Se un nome di tabella viene passato come argomento al Fill metodo, alle tabelle viene assegnato un nome predefinito incrementale TableNameN, a partire da "TableName" per TableName0.

È possibile usare un numero qualsiasi di oggetti con un set di Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter dati. Ogni oggetto Microsoft.HostIntegration.MsDb2Client.MsDb2DataAdapter può essere usato per compilare uno o più oggetti DataTable e risolvere gli aggiornamenti fino all'origine dati pertinente. È possibile aggiungere DataRelation oggetti e Constraint al set di dati in locale, consentendo di correlare i dati da origini dati diverse.

Vedere anche

Uso di adattatori e set di dati per un database DB2
Uso del provider gestito per DB2