DataAdapter.Fill Método

Definición

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.Adds or refreshes rows in the DataSet to match those in the data source.

Sobrecargas

Fill(DataSet)

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataTable, IDataReader)

Agrega filas al objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando el nombre de DataTable y la interfaz IDataReader especificada.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)

Agrega filas en un intervalo especificado de la colección de objetos DataTable o las actualiza para hacerlas coincidir con las filas del origen de datos.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)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y 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)

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.Adds or refreshes rows in the DataSet to match those in the data source.

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

Parámetros

dataSet
DataSet

Clase DataSet que se va a rellenar con registros y, si es necesario, con un esquema.A DataSet to fill with records and, if necessary, schema.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataSet.The number of rows successfully added to or refreshed in the DataSet. No se incluyen las filas afectadas por instrucciones que no devuelven filas.This does not include rows affected by statements that do not return rows.

Implementaciones

Comentarios

El Fill método recupera filas del origen de datos mediante la instrucción SELECT especificada por una propiedad asociada SelectCommand .The Fill method retrieves rows from the data source using the SELECT statement specified by an associated SelectCommand property. El objeto de conexión asociado a la instrucción SELECT debe ser válido, pero no es necesario que esté abierto.The connection object associated with the SELECT statement must be valid, but it does not need to be open. Si la conexión se cierra antes de que Fill se llame a, se abre para recuperar los datos y, a continuación, se cierra.If the connection is closed before Fill is called, it is opened to retrieve data, then closed. Si la conexión está abierta antes Fill de que se llame a, permanece abierta.If the connection is open before Fill is called, it remains open.

FillA continuación, la operación agrega las filas a los DataTable objetos de destino en DataSet y crea los DataTable objetos si aún no existen.The Fill operation then adds the rows to destination DataTable objects in the DataSet, creating the DataTable objects if they do not already exist. Al crear DataTable objetos, la Fill operación normalmente solo crea metadatos de nombre de columna.When creating DataTable objects, the Fill operation normally creates only column name metadata. Sin embargo, si la MissingSchemaAction propiedad se establece en AddWithKey , también se crean las claves principales y las restricciones correspondientes.However, if the MissingSchemaAction property is set to AddWithKey, appropriate primary keys and constraints are also created.

Si SelectCommand devuelve los resultados de OUTER JOIN, DataAdapter no establece un valor PrimaryKey para el objeto DataTableresultante.If the SelectCommand returns the results of an OUTER JOIN, the DataAdapter does not set a PrimaryKey value for the resulting DataTable. Debe definir explícitamente la clave principal para asegurarse de que las filas duplicadas se resuelven correctamente.You must explicitly define the primary key to ensure that duplicate rows are resolved correctly. Para obtener más información, vea definir claves principales.For more information, see Defining Primary Keys.

Si el adaptador de datos encuentra columnas duplicadas al rellenar una DataTable , genera nombres para las columnas siguientes, utilizando el patrón "nombredecolumna1", "nombredecolumna2", "nombredecolumna3", etc.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. Si los datos entrantes contienen columnas sin nombre, se colocan en DataSet según el patrón "Column1", "columna2", etc.If the incoming data contains unnamed columns, they are placed in the DataSet according to the pattern "Column1", "Column2", and so on. Cuando se agregan varios conjuntos de resultados a DataSet cada conjunto de resultados, se coloca en una tabla independiente.When multiple result sets are added to the DataSet each result set is placed in a separate table. Los conjuntos de resultados adicionales se denominan anexando valores enteros al nombre de tabla especificado (por ejemplo, "Table", "Table1", "Tabla2", etc.).Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Las aplicaciones que usan nombres de tabla y columna deben garantizar que no se produzcan conflictos con estos patrones de nomenclatura.Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

Cuando la instrucción SELECT usada para rellenar DataSet devuelve varios resultados, como las instrucciones SQL por lotes, si uno de los resultados contiene un error, todos los resultados subsiguientes se omiten y no se agregan a DataSet .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.

Puede usar el Fill método varias veces en el mismo DataTable .You can use the Fill method multiple times on the same DataTable. Si existe una clave principal, las filas entrantes se combinan con filas coincidentes que ya existen.If a primary key exists, incoming rows are merged with matching rows that already exist. Si no existe ninguna clave principal, las filas entrantes se anexan a DataTable .If no primary key exists, incoming rows are appended to the DataTable.

Nota

Al controlar instrucciones SQL por lotes que devuelven varios resultados, la implementación de FillSchema para el proveedor de datos de .NET Framework para OLE DB recupera información de esquema solo para el primer resultado.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. Para recuperar información de esquema para varios resultados, use Fill con el MissingSchemaAction establecido en AddWithKey .To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

Consulte también

Se aplica a

Fill(DataTable, IDataReader)

Agrega filas al objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando el nombre de DataTable y la interfaz IDataReader especificada.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
Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer

Parámetros

dataTable
DataTable

Objeto DataTable que se va a llenar de registros.A DataTable to fill with records.

dataReader
IDataReader

Instancia de IDataReader.An instance of IDataReader.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataTable.The number of rows successfully added to or refreshed in the DataTable. No se incluyen las filas afectadas por instrucciones que no devuelven filas.This does not include rows affected by statements that do not return rows.

Comentarios

Vea la sección Comentarios para DataAdapter.Fill(DataSet) obtener información adicional.See the remarks for DataAdapter.Fill(DataSet) for additional information.

Se aplica a

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

Agrega filas en un intervalo especificado de la colección de objetos DataTable o las actualiza para hacerlas coincidir con las filas del origen de datos.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

Parámetros

dataTables
DataTable[]

Colección de objetos DataTable que se va a llenar de registros.A collection of DataTable objects to fill with records.

dataReader
IDataReader

Instancia de IDataReader.An instance of IDataReader.

startRecord
Int32

Índice de base cero de la búsqueda del registro inicial.The zero-based index of the starting record.

maxRecords
Int32

Entero que indica el máximo número de registros.An integer indicating the maximum number of records.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataTable.The number of rows successfully added to or refreshed in the DataTable. No se incluyen las filas afectadas por instrucciones que no devuelven filas.This does not include rows affected by statements that do not return rows.

Comentarios

Vea la sección Comentarios para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obtener información adicional.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Se aplica a

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

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y 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
Protected Overridable Function Fill (dataSet As DataSet, srcTable As String, dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Parámetros

dataSet
DataSet

Objeto DataSet que se va a llenar de registros.A DataSet to fill with records.

srcTable
String

Cadena que indica el nombre de la tabla de origen.A string indicating the name of the source table.

dataReader
IDataReader

Instancia de IDataReader.An instance of IDataReader.

startRecord
Int32

Índice de base cero de la búsqueda del registro inicial.The zero-based index of the starting record.

maxRecords
Int32

Entero que indica el máximo número de registros.An integer indicating the maximum number of records.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataSet.The number of rows successfully added to or refreshed in the DataSet. No se incluyen las filas afectadas por instrucciones que no devuelven filas.This does not include rows affected by statements that do not return rows.

Comentarios

Vea la sección Comentarios para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obtener información adicional.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Se aplica a