Реализации

IDataAdapter.Fill(DataSet)

Заметки

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

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

Если свойство SelectCommand возвращает результаты OUTER JOIN, объект DataAdapter не задает значение свойства PrimaryKey для результирующего объекта DataTable. Необходимо явно определить первичный ключ, чтобы убедиться в том, что дублированные строки разрешены правильно. Для получения дополнительной информации см. Defining a Primary Key for a Table.

Если адаптер данных обнаруживает дублированные столбцы при заполнении объекта DataTable, он создает имена для последующих столбцов, используя шаблон "имя_столбца1", "имя_столбца2", "имя_столбца3" и т. д. Если входные данные содержат неименованные столбцы, они помещаются в объект DataSet в соответствии с шаблоном "Столбец1", "Столбец2" и т. д. При добавлении нескольких наборов результатов в объект DataSet каждый из них помещается в отдельную таблицу.Дополнительным наборам результатов присваиваются имена с добавлением целых чисел к заданным именам таблиц, например "Таблица1", "Таблица2" и т. д. Приложения, использующие имена столбцов и таблиц, должны обеспечивать отсутствие конфликтов шаблонов именования.

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

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