Поделиться через


DataAdapter.Fill Метод

Определение

Добавляет или обновляет строки в DataSet для получения соответствия строкам в источнике данных.

Перегрузки

Fill(DataSet)

Добавляет или обновляет строки в DataSet для получения соответствия строкам в источнике данных.

Fill(DataTable, IDataReader)

Добавляет или обновляет строки в DataTable для получения соответствия строкам в источнике данных с помощью имени DataTable и указанного интерфейса IDataReader.

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

Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных.

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

Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable.

Fill(DataSet)

Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs

Добавляет или обновляет строки в DataSet для получения соответствия строкам в источнике данных.

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

Параметры

dataSet
DataSet

Объект DataSet для заполнения записями и, если необходимо, — схемой.

Возвращаемое значение

Количество строк, успешно добавленных или обновленных в объекте DataSet. Не включает строки, на которые воздействуют операторы, не возвращающие строк.

Реализации

Комментарии

Метод Fill извлекает строки из источника данных с помощью инструкции SELECT, заданной связанным SelectCommand свойством. Объект подключения, связанный с инструкцией SELECT, должен быть допустимым, но его не нужно открывать. Если соединение закрыто перед Fill вызовом, оно открывается для получения данных, а затем закрывается. Если подключение открыто до Fill вызова, оно остается открытым.

Затем Fill операция добавляет строки в целевые DataTable объекты в DataSet, создавая DataTable объекты , если они еще не существуют. При создании DataTable объектов Fill операция обычно создает только метаданные имени столбца. Однако если MissingSchemaAction для свойства задано значение AddWithKey, также создаются соответствующие первичные ключи и ограничения.

Если SelectCommand возвращает результаты OUTER JOIN, то DataAdapter не задает значение PrimaryKey для результирующего объекта DataTable. Чтобы обеспечить правильное разрешение повторяющихся строк, необходимо явно определить первичный ключ. Дополнительные сведения см. в разделе Определение первичных ключей.

Если адаптер данных обнаруживает повторяющиеся столбцы при заполнении DataTable, он создает имена для последующих столбцов с использованием шаблонов columnname1, columnname2, columnname3 и т. д. Если входящие данные содержат неименованные столбцы, они помещаются в DataSet в соответствии с шаблонами "Столбец1", "Столбец2" и т. д. При добавлении нескольких результирующих наборов в DataSet каждый результирующий набор помещается в отдельную таблицу. Дополнительные результирующие наборы именуются путем добавления целочисленных значений к указанному имени таблицы (например, "Table", "Table1", "Table2" и т. д.). Приложения, использующие имена столбцов и таблиц, должны гарантировать, что не возникают конфликты с этими шаблонами именования.

Если инструкция SELECT, используемая для заполнения DataSet , возвращает несколько результатов, таких как пакетные инструкции SQL, если один из результатов содержит ошибку, все последующие результаты пропускаются и не добавляются в DataSet.

Метод можно использовать Fill несколько раз для одного и того же DataTable. Если первичный ключ существует, входящие строки объединяются с соответствующими строками, которые уже существуют. Если первичный ключ не существует, входящие строки добавляются в DataTable.

Примечание

При обработке пакетных инструкций SQL, возвращающих несколько результатов, реализация FillSchema для поставщика данных платформа .NET Framework для OLE DB извлекает сведения о схеме только для первого результата. Чтобы получить сведения о схеме для нескольких результатов, используйте Fill с заданным значением MissingSchemaActionAddWithKey.

См. также раздел

Применяется к

Fill(DataTable, IDataReader)

Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs

Добавляет или обновляет строки в DataTable для получения соответствия строкам в источнике данных с помощью имени DataTable и указанного интерфейса 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

Параметры

dataTable
DataTable

DataTable для заполнения записями.

dataReader
IDataReader

Экземпляр IDataReader.

Возвращаемое значение

Количество строк, успешно добавленных или обновленных в объекте DataTable. Не включает строки, на которые воздействуют операторы, не возвращающие строк.

Комментарии

Дополнительные сведения см. в примечаниях DataAdapter.Fill(DataSet) .

См. также раздел

Применяется к

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

Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs

Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных.

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

Параметры

dataTables
DataTable[]

Коллекция объектов DataTable для заполнения записями.

dataReader
IDataReader

Экземпляр IDataReader.

startRecord
Int32

Индекс (с нуля) начальной записи.

maxRecords
Int32

Целое число, указывающее максимальное количество записей.

Возвращаемое значение

Количество строк, успешно добавленных или обновленных в объекте DataTable. Не включает строки, на которые воздействуют операторы, не возвращающие строк.

Комментарии

Дополнительные сведения см. в примечаниях System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

См. также раздел

Применяется к

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

Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs
Исходный код:
DataAdapter.cs

Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и 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

Параметры

dataSet
DataSet

DataSet для заполнения записями.

srcTable
String

Строка, указывающая имя исходной таблицы.

dataReader
IDataReader

Экземпляр IDataReader.

startRecord
Int32

Индекс (с нуля) начальной записи.

maxRecords
Int32

Целое число, указывающее максимальное количество записей.

Возвращаемое значение

Количество строк, успешно добавленных или обновленных в объекте DataSet. Не включает строки, на которые воздействуют операторы, не возвращающие строк.

Комментарии

Дополнительные сведения см. в примечаниях System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

См. также раздел

Применяется к