DataAdapter.Fill Метод

Определение

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

Сборки:: netstandard.dll, System.Data.Common.dll

Сборка:: 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

Исходный код:: 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 возвращает результаты ВНЕШНЕГО СОЕДИНЕНИЯ, DataAdapter не устанавливает значение PrimaryKey для результирующего DataTable. Необходимо явно определить первичный ключ, чтобы убедиться, что повторяющиеся строки разрешаются правильно. Дополнительные сведения см. в разделе "Определение первичных ключей".

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

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

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

Замечание

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

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

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

Fill(DataTable, IDataReader)

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

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

Исходный код:: 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

Исходный код:: 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

Исходный код:: 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)

Параметры

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

Комментарии

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

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