DataAdapter.Fill Método

  • Referencia

Definición

Espacio de nombres:
System.Data.Common
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.

Sobrecargas

Fill(DataSet)

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.
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.
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.
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.

Fill(DataSet)

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

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.

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.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataSet. No se incluyen las filas afectadas por instrucciones que no devuelven filas.

Implementaciones

Fill(DataSet)

Comentarios

El Fill método recupera filas del origen de datos mediante la instrucción SELECT especificada por una propiedad asociada SelectCommand . El objeto de conexión asociado a la instrucción SELECT debe ser válido, pero no es necesario abrirlo. Si se cierra la conexión antes Fill de llamar a , se abre para recuperar datos y, a continuación, se cierra. Si la conexión está abierta antes Fill de llamar a , permanece abierta.

A Fill continuación, la operación agrega las filas a los objetos de destino DataTable en DataSet, creando los DataTable objetos si aún no existen. Al crear DataTable objetos, la Fill operación normalmente crea solo metadatos de nombre de columna. Sin embargo, si la MissingSchemaAction propiedad se establece AddWithKeyen , también se crean las restricciones y las claves principales adecuadas.

Si SelectCommand devuelve los resultados de OUTER JOIN, DataAdapter no establece un valor PrimaryKey para el objeto DataTableresultante. Debe definir explícitamente la clave principal para asegurarse de que las filas duplicadas se resuelven correctamente. Para más información, consulte Definir claves principales.

Si el adaptador de datos encuentra columnas duplicadas mientras rellena un DataTable, genera nombres para las columnas posteriores, utilizando el patrón "columnname1", "columnname2", "columnname3", etc. Si los datos entrantes contienen columnas sin nombre, se colocan en según el DataSet patrón "Column1", "Column2", etc. Cuando se agregan varios conjuntos de resultados al DataSet conjunto de resultados, cada conjunto de resultados se coloca en una tabla independiente. Los conjuntos de resultados adicionales se denominan anexando valores enteros al nombre de tabla especificado (por ejemplo, "Table", "Table1", "Table2", etc.). Las aplicaciones que usan nombres de columna y tabla deben asegurarse de que no se produzcan conflictos con estos patrones de nomenclatura.

Cuando la instrucción SELECT usada para rellenar DataSet devuelve varios resultados, como instrucciones SQL por lotes, si uno de los resultados contiene un error, se omiten todos los resultados posteriores y no se agregan a DataSet.

Puede usar el Fill método varias veces en el mismo DataTable. Si existe una clave principal, las filas entrantes se combinan con filas coincidentes que ya existen. Si no existe ninguna clave principal, las filas entrantes se anexan a 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. Para recuperar información de esquema para varios resultados, use Fill con el MissingSchemaAction establecido en AddWithKey.

Consulte también

Se aplica a

Fill(DataTable, IDataReader)

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

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.

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.

dataReader
IDataReader

Instancia de IDataReader.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataTable. No se incluyen las filas afectadas por instrucciones que no devuelven filas.

Comentarios

Consulte los comentarios para DataAdapter.Fill(DataSet) obtener información adicional.

Consulte también

Se aplica a

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

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

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.

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.

dataReader
IDataReader

Instancia de IDataReader.

startRecord
Int32

Índice de base cero de la búsqueda del registro inicial.

maxRecords
Int32

Entero que indica el máximo número de registros.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataTable. No se incluyen las filas afectadas por instrucciones que no devuelven filas.

Comentarios

Consulte los comentarios para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obtener información adicional.

Consulte también

Se aplica a

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

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

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.

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.

srcTable
String

Cadena que indica el nombre de la tabla de origen.

dataReader
IDataReader

Instancia de IDataReader.

startRecord
Int32

Índice de base cero de la búsqueda del registro inicial.

maxRecords
Int32

Entero que indica el máximo número de registros.

Devoluciones

Int32

Número de filas agregadas o actualizadas correctamente en la clase DataSet. No se incluyen las filas afectadas por instrucciones que no devuelven filas.

Comentarios

Consulte los comentarios para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obtener información adicional.

Consulte también

Se aplica a