DataAdapter.Fill Metodo

Definizione

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.

Overload

Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.

Fill(DataTable, IDataReader)

Aggiunge o aggiorna righe nell'oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando il nome di DataTable e l'oggetto IDataReader specificato.

Fill(DataTable[], IDataReader, Int32, Int32)

Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di oggetti DataTable affinché corrispondano a quelle nell'origine dati.

Fill(DataSet, String, IDataReader, Int32, Int32)

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable.

Fill(DataSet)

Source:
DataAdapter.cs
Source:
DataAdapter.cs
Source:
DataAdapter.cs

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);
public:
 abstract int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill (System.Data.DataSet dataSet);
public abstract int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int
abstract member Fill : System.Data.DataSet -> int
Public Overridable Function Fill (dataSet As DataSet) As Integer
Public MustOverride Function Fill (dataSet As DataSet) As Integer

Parametri

dataSet
DataSet

Oggetto DataSet in cui inserire i record e, se necessario, lo schema.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataSet. Non sono incluse righe modificate da istruzioni che non restituiscono righe.

Implementazioni

Commenti

Il Fill metodo recupera le righe dall'origine dati utilizzando l'istruzione SELECT specificata da una proprietà associata SelectCommand . L'oggetto connessione associato all'istruzione SELECT deve essere valido, ma non deve essere aperto. Se la connessione viene chiusa prima Fill della chiamata, viene aperta per recuperare i dati, quindi chiusa. Se la connessione è aperta prima Fill della chiamata, rimane aperta.

L'operazione Fill aggiunge quindi le righe agli oggetti di destinazione DataTable in DataSet, creando gli DataTable oggetti se non esistono già. Quando si creano DataTable oggetti, l'operazione Fill in genere crea solo i metadati del nome di colonna. Tuttavia, se la MissingSchemaAction proprietà è impostata su AddWithKey, vengono create anche chiavi primarie e vincoli appropriati.

Se SelectCommand restituisce i risultati di un OUTER JOIN, mediante DataAdapter non viene impostato un valore di PrimaryKey per l'oggetto DataTablerisultante. È necessario definire in modo esplicito la chiave primaria per assicurarsi che le righe duplicate vengano risolte correttamente. Per altre informazioni, vedere Definizione delle chiavi primarie.

Se l'adattatore dati rileva colonne duplicate durante il popolamento di , DataTablegenera nomi per le colonne successive, usando il modello "columnname1", "columnname2", "columnname3" e così via. Se i dati in ingresso contengono colonne senza nome, vengono posizionate in DataSet base al modello "Column1", "Column2" e così via. Quando vengono aggiunti più set di risultati a DataSet ogni set di risultati viene inserito in una tabella separata. I set di risultati aggiuntivi vengono denominati aggiungendo valori integrali al nome della tabella specificato, ad esempio "Table", "Table1", "Table2" e così via. Le applicazioni che usano nomi di colonna e tabella devono garantire che non si verifichino conflitti con questi modelli di denominazione.

Quando l'istruzione SELECT utilizzata per popolare restituisce DataSet più risultati, ad esempio istruzioni SQL batch, se uno dei risultati contiene un errore, tutti i risultati successivi vengono ignorati e non aggiunti a DataSet.

È possibile usare il Fill metodo più volte nello stesso DataTableoggetto . Se esiste una chiave primaria, le righe in ingresso vengono unite alle righe corrispondenti già esistenti. Se non esiste alcuna chiave primaria, le righe in ingresso vengono aggiunte a DataTable.

Nota

Quando si gestiscono istruzioni SQL batch che restituiscono più risultati, l'implementazione di FillSchema per il provider di dati .NET Framework per OLE DB recupera le informazioni sullo schema solo per il primo risultato. Per recuperare le informazioni sullo schema per più risultati, usare Fill con l'oggetto MissingSchemaAction impostato su AddWithKey.

Vedi anche

Si applica a

Fill(DataTable, IDataReader)

Source:
DataAdapter.cs
Source:
DataAdapter.cs
Source:
DataAdapter.cs

Aggiunge o aggiorna righe nell'oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando il nome di DataTable e l'oggetto IDataReader specificato.

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);
protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDataReader dataReader);
abstract member Fill : System.Data.DataTable * System.Data.IDataReader -> int
override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int
Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer

Parametri

dataTable
DataTable

Classe DataTable in cui inserire record.

dataReader
IDataReader

Istanza di IDataReader.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataTable. Non sono incluse righe modificate da istruzioni che non restituiscono righe.

Commenti

Per altre informazioni, vedere le DataAdapter.Fill(DataSet) osservazioni.

Vedi anche

Si applica a

Fill(DataTable[], IDataReader, Int32, Int32)

Source:
DataAdapter.cs
Source:
DataAdapter.cs
Source:
DataAdapter.cs

Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di oggetti DataTable affinché corrispondano a quelle nell'origine dati.

protected:
 virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataTables As DataTable(), dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Parametri

dataTables
DataTable[]

Insieme di oggetti DataTable in cui inserire record.

dataReader
IDataReader

Istanza di IDataReader.

startRecord
Int32

Indice iniziale in base zero del record di inizio.

maxRecords
Int32

Intero che indica il numero massimo di record.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataTable. Non sono incluse righe modificate da istruzioni che non restituiscono righe.

Commenti

Per altre informazioni, vedere le System.Data.Common.DataAdapter.Fill(System.Data.DataSet) osservazioni.

Vedi anche

Si applica a

Fill(DataSet, String, IDataReader, Int32, Int32)

Source:
DataAdapter.cs
Source:
DataAdapter.cs
Source:
DataAdapter.cs

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable.

protected:
 virtual int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataSet As DataSet, srcTable As String, dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Parametri

dataSet
DataSet

Classe DataSet in cui inserire record.

srcTable
String

Stringa che indica il nome della tabella di origine.

dataReader
IDataReader

Istanza di IDataReader.

startRecord
Int32

Indice iniziale in base zero del record di inizio.

maxRecords
Int32

Intero che indica il numero massimo di record.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataSet. Non sono incluse righe modificate da istruzioni che non restituiscono righe.

Commenti

Per altre informazioni, vedere le System.Data.Common.DataAdapter.Fill(System.Data.DataSet) osservazioni.

Vedi anche

Si applica a