DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill Method

Definizione

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.Adds or refreshes rows in the DataSet to match those in the data source.

Overload

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) 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.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.Adds or refreshes rows in the DataSet to match those in the data source.

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int

Parametri

dataSet
DataSet DataSet DataSet DataSet

Oggetto DataSet in cui inserire i record e, se necessario, lo schema.A DataSet to fill with records and, if necessary, schema.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataSet.The number of rows successfully added to or refreshed in the DataSet. Non sono incluse righe modificate da istruzioni che non restituiscono righe.This does not include rows affected by statements that do not return rows.

Implementazioni

Commenti

Il Fill metodo recupera le righe dall'origine dati utilizzando l'istruzione SELECT specificata da una proprietà SelectCommand associata.The Fill method retrieves rows from the data source using the SELECT statement specified by an associated SelectCommand property. L'oggetto Connection associato all'istruzione SELECT deve essere valido, ma non è necessario aprirlo.The connection object associated with the SELECT statement must be valid, but it does not need to be open. Se la connessione viene chiusa prima Fill che venga chiamato, viene aperta per recuperare i dati e quindi chiusa.If the connection is closed before Fill is called, it is opened to retrieve data, then closed. Se la connessione è aperta prima Fill che venga chiamato, resta aperta.If the connection is open before Fill is called, it remains open.

L' Fill operazione aggiunge quindi le righe agli oggetti DataTable di destinazione in DataSet, creando gli DataTable oggetti se non esistono già.The Fill operation then adds the rows to destination DataTable objects in the DataSet, creating the DataTable objects if they do not already exist. Quando si DataTable creano oggetti, Fill l'operazione crea in genere solo i metadati del nome di colonna.When creating DataTable objects, the Fill operation normally creates only column name metadata. Tuttavia, se la MissingSchemaAction proprietà è impostata su AddWithKey, vengono creati anche i vincoli e le chiavi primarie appropriate.However, if the MissingSchemaAction property is set to AddWithKey, appropriate primary keys and constraints are also created.

Se SelectCommand restituisce i risultati di un OUTER JOIN, mediante DataAdapter non viene impostato un valore di PrimaryKey per l'oggetto DataTablerisultante.If the SelectCommand returns the results of an OUTER JOIN, the DataAdapter does not set a PrimaryKey value for the resulting DataTable. È necessario definire in modo esplicito la chiave primaria per assicurarsi che le righe duplicate vengano risolte correttamente.You must explicitly define the primary key to ensure that duplicate rows are resolved correctly. Per ulteriori informazioni, vedere definizione delle chiavi primarie.For more information, see Defining Primary Keys.

Se l'adattatore dati rileva colonne duplicate durante il popolamento di DataTableun oggetto, genera nomi per le colonne successive, usando il modello "nomecolonna1", "nomecolonna2", "nomecolonna3" e così via.If the data adapter encounters duplicate columns while populating a DataTable, it generates names for the subsequent columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. Se i dati in arrivo contengono colonne senza nome, vengono inseriti in in DataSet base al modello "Column1", "Column2" e così via.If the incoming data contains unnamed columns, they are placed in the DataSet according to the pattern "Column1", "Column2", and so on. Quando più set di risultati vengono aggiunti a DataSet ogni set di risultati viene inserito in una tabella separata.When multiple result sets are added to the DataSet each result set is placed in a separate table. I set di risultati aggiuntivi vengono denominati aggiungendo valori integrali al nome della tabella specificato, ad esempio "Table", "Tabella1", "Table2" e così via.Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Le applicazioni che utilizzano nomi di colonna e di tabella devono garantire che non si verifichino conflitti con questi modelli di denominazione.Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

Quando l'istruzione SELECT usata per popolare DataSet restituisce più risultati, ad esempio istruzioni SQL di batch, se uno dei risultati contiene un errore, tutti i risultati successivi vengono ignorati e non vengono aggiunti DataSeta.When the SELECT statement used to populate the DataSet returns multiple results, such as a batch SQL statements, if one of the results contains an error, all subsequent results are skipped and not added to the DataSet.

È possibile usare il Fill metodo più volte nello stesso. DataTableYou can use the Fill method multiple times on the same DataTable. Se esiste una chiave primaria, le righe in ingresso vengono unite alle righe corrispondenti già esistenti.If a primary key exists, incoming rows are merged with matching rows that already exist. Se non esiste alcuna chiave primaria, le DataTablerighe in ingresso vengono accodate a.If no primary key exists, incoming rows are appended to the DataTable.

Nota

Quando si gestiscono istruzioni SQL batch che restituiscono più risultati, FillSchema l'implementazione di per la .NET Framework provider di dati per OLE DB recupera le informazioni sullo schema solo per il primo risultato.When handling batch SQL statements that return multiple results, the implementation of FillSchema for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. Per recuperare informazioni sullo schema per più risultati, Fill utilizzare MissingSchemaAction con impostato su AddWithKey.To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

Vedi anche

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) 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.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified 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

Parametri

dataTable
DataTable DataTable DataTable DataTable

Classe DataTable in cui inserire record.A DataTable to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Istanza di IDataReader.An instance of IDataReader.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataTable.The number of rows successfully added to or refreshed in the DataTable. Non sono incluse righe modificate da istruzioni che non restituiscono righe.This does not include rows affected by statements that do not return rows.

Commenti

DataAdapter.Fill(DataSet) Per ulteriori informazioni, vedere la sezione Osservazioni.See the remarks for DataAdapter.Fill(DataSet) for additional information.

Vedi anche

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

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.A collection of DataTable objects to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Istanza di IDataReader.An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Indice iniziale in base zero del record di inizio.The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Intero che indica il numero massimo di record.An integer indicating the maximum number of records.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataTable.The number of rows successfully added to or refreshed in the DataTable. Non sono incluse righe modificate da istruzioni che non restituiscono righe.This does not include rows affected by statements that do not return rows.

Commenti

System.Data.Common.DataAdapter.Fill(System.Data.DataSet) Per ulteriori informazioni, vedere la sezione Osservazioni.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Vedi anche

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

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

Parametri

dataSet
DataSet DataSet DataSet DataSet

Classe DataSet in cui inserire record.A DataSet to fill with records.

srcTable
String String String String

Stringa che indica il nome della tabella di origine.A string indicating the name of the source table.

dataReader
IDataReader IDataReader IDataReader IDataReader

Istanza di IDataReader.An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Indice iniziale in base zero del record di inizio.The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Intero che indica il numero massimo di record.An integer indicating the maximum number of records.

Restituisce

Numero di righe aggiunte o aggiornate correttamente nell'oggetto DataSet.The number of rows successfully added to or refreshed in the DataSet. Non sono incluse righe modificate da istruzioni che non restituiscono righe.This does not include rows affected by statements that do not return rows.

Commenti

System.Data.Common.DataAdapter.Fill(System.Data.DataSet) Per ulteriori informazioni, vedere la sezione Osservazioni.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Vedi anche

Si applica a