DataAdapter.Fill Metodo

Definizione

Spazio dei nomi:: System.Data.Common

Assembly:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Overload

Nome	Descrizione
Fill(DataSet)	Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati.
Fill(DataTable, IDataReader)	Aggiunge o aggiorna righe nell'oggetto DataTable in modo che corrispondano a quelle nell'origine dati usando il DataTable nome e l'oggetto specificato IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di DataTable oggetti in modo che corrispondano a quelli nell'origine dati.
Fill(DataSet, String, IDataReader, Int32, Int32)	Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable .

Fill(DataSet)

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'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 da compilare con record e, se necessario, schema.

Restituisce

Int32

Numero di righe aggiunte o aggiornate correttamente in DataSet. Non sono incluse le righe interessate dalle istruzioni che non restituiscono righe.

Implementazioni

Fill(DataSet)

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 dei nomi 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, DataAdapter non imposta un valore PrimaryKey per l'elemento risultante DataTable. È 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 nell'oggetto DataSet in 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 di tabella devono garantire che non si verifichino conflitti con questi modelli di denominazione.

Quando l'istruzione SELECT usata 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 con righe corrispondenti già esistenti. Se non esiste alcuna chiave primaria, le righe in ingresso vengono aggiunte all'oggetto DataTable.

Annotazioni

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

Vedi anche

Si applica a

Fill(DataTable, IDataReader)

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Aggiunge o aggiorna righe nell'oggetto DataTable in modo che corrispondano a quelle nell'origine dati usando il DataTable nome e l'oggetto specificato IDataReader.

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

Oggetto DataTable da riempire con i record.

dataReader: IDataReader

Istanza di IDataReader.

Restituisce

Int32

Numero di righe aggiunte o aggiornate correttamente in DataTable. Non sono incluse le righe interessate dalle istruzioni che non restituiscono righe.

Commenti

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

Vedi anche

Panoramica di ADO.NET

Si applica a

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

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di DataTable oggetti in modo che corrispondano a quelli 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[]

Raccolta di DataTable oggetti da riempire con record.

dataReader: IDataReader

Istanza di IDataReader.

startRecord: Int32

Indice in base zero del record iniziale.

maxRecords: Int32

Intero che indica il numero massimo di record.

Restituisce

Int32

Numero di righe aggiunte o aggiornate correttamente in DataTable. Non sono incluse le righe interessate dalle istruzioni che non restituiscono righe.

Commenti

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

Vedi anche

Panoramica di ADO.NET

Si applica a

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

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Origine:: DataAdapter.cs

Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e 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

Oggetto DataSet da riempire con i record.

srcTable: String

Stringa che indica il nome della tabella di origine.

dataReader: IDataReader

Istanza di IDataReader.

startRecord: Int32

Indice in base zero del record iniziale.

maxRecords: Int32

Intero che indica il numero massimo di record.

Restituisce

Int32

Numero di righe aggiunte o aggiornate correttamente in DataSet. Non sono incluse le righe interessate dalle istruzioni che non restituiscono righe.

Commenti

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

Vedi anche

Panoramica di ADO.NET

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

DataAdapter.Fill Metodo

Definizione

Overload

Fill(DataSet)

Parametri

Restituisce

Implementazioni

Commenti

Vedi anche

Si applica a

Fill(DataTable, IDataReader)

Parametri

Restituisce

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti