DataAdapter.Fill Метод

Ссылка

Определение

Пространство имен:: System.Data.Common

Сборка:: System.Data.Common.dll

Сборка:: System.Data.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Добавляет или обновляет строки в 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 для заполнения записями и, если необходимо, — схемой.

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

Int32

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

Реализации

Fill(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.

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

Int32

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

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

Общие сведения об ADO.NET

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

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

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

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

Int32

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

Общие сведения об ADO.NET

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

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

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

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

Int32

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

Общие сведения об ADO.NET

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

DataAdapter.Fill Метод

Определение

Перегрузки

Fill(DataSet)

Параметры

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

Реализации

Комментарии

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

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

Fill(DataTable, IDataReader)

Параметры

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

Комментарии

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

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

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

Параметры

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

Комментарии

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

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

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

Параметры

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

Комментарии

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

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

Обратная связь

Дополнительные ресурсы