IDtExcelProvider

Интерфейс IDtExcelProvider содержит свойства и методы источника данных - Импорт из Excel(97-2003).

Иерархия наследования

Комментарии

Если в 64-х битной операционной системе установлен продукт «Форсайт. Аналитическая платформа» разрядностью 64 бита, но не установлен Microsoft Office, то для работы с файлами Microsoft Excel, использующими данный интерфейс, и файлами Microsoft Access необходимо установить Microsoft Office разрядностью 64 бита.

Примечание. Для корректного выполнения импорта данных разрядность «Форсайт. Аналитическая платформа» должна совпадать с разрядностью Microsoft Office.

При работе используется один из следующих провайдеров: Microsoft.Jet.OLEDB.4.0 или Microsoft.ACE.OLEDB.12.0. Провайдер выбирается автоматически в зависимости от определенных условий:

Примечание. При указании свойства IDtExcelProvider.DriverVersion также будет проверяться фактическая структура передаваемого файла (бинарный или Office Open XML). Если фактическая структура не совпадает с версией Microsoft Office, которой соответствует драйвер, то используемый провайдер будет автоматически изменен.

В зависимости от значения свойства ImexMode выбирается режим, в котором будет производиться импорт данных разных типов. При этом учитываются значения следующих ключей реестра:

В зависимости от используемого провайдера будут использоваться ключи, хранящиеся в разных ветках реестра:

При импорте отсутствует возможность указать длину загружаемых записей полей. Длина поля будет определяться автоматически по первым ячейкам, по которым также определяется тип данных. Если тип данных определен как Text и в этих ячейках отсутствуют значения, длина которых больше 255 символов, то при импорте все строковые значения будут загружены с ограничением в 255 символов. Для избежания обрезания записей задайте в ключе TypeGuessRows значение 0, при этом определение типа данных и вычисление максимальной длины будет производиться по всем записям полей.

Для проверки структуры файла формата XLS ознакомьтесь с примером.

Свойства

	Имя свойства	Краткое описание
	CheckFieldName	Свойство CheckFieldName определяет, будут ли преобразовываться наименования полей таким образом, чтобы можно было импортировать числовые наименования.
	DriverVersion	Свойство DriverVersion определяет версию драйвера, используемого при работе с файлом.
	File	Свойство File определяет путь и наименование файла, из которого будет производиться импорт данных.
	HasHeader	Свойство HasHeader определяет признак загрузки из первой строки файла списка заголовков полей.
	ImexMode	Свойство ImexMode определяет режим, в котором будет производиться импорт из столбцов, содержащих данные разных типов.
	Query	Свойство Query определяет запрос к листам файла Excel.

Свойства, унаследованные от IDtProvider

	Имя свойства	Краткое описание
	AutoFillFieldsMode	Свойство AutoFillFieldsMode определяет режим распознавания типа полей источника данных.
	CalcFieldsErrors	Свойство CalcFieldsErrors возвращает коллекцию ошибок, возникших при расчете вычисляемых полей.
	Eof	Свойство Eof возвращает признак расположения курсора в источнике данных на последней записи.
	FetchErrors	Свойство FetchErrors возвращает ошибки, возникшие при импорте данных.
	FilterIf	Свойство FilterIf возвращает условие загрузки записей из источника данных.
	StringDataFormat	Свойство StringDataFormat возвращает настройки, используемые при идентификации данных.
	TypeGuessRows	Свойство TypeGuessRows определяет количество строк, по которым будет определяться тип данных каждого поля.

Свойства, унаследованные от IDtObject

	Имя свойства	Краткое описание
	Active	Свойство Active возвращает состояние источника/приёмника данных.
	Fields	Свойство Fields возвращает описание полей источника/приёмника данных.
	GetType	Свойство GetType возвращает тип источника/приёмника данных.
	Metabase	Свойство Metabase определяет репозиторий, в котором выполняется импорт или экспорт данных.

Методы, унаследованные от IDtProvider

	Имя метода	Краткое описание
	Fetch	Метод Fetch осуществляет чтение данных текущей записи из источника данных.
	FetchRows	Метод FetchRows осуществляет чтение данных указанного количества записей из источника данных и возвращает количество фактически считанных записей.
	ReadingRowsCount	Метод ReadingRowsCount возвращает количество записей, считанных из источника данных с учетом условия загрузки.
	ReadingRowsTotalCount	Метод ReadingRowsTotalCount возвращает количество записей, считанных из источника данных без учета условия загрузки.

Методы, унаследованные от IDtObject

	Имя метода	Краткое описание
	ClearFields	Метод ClearFields очищает список полей приёмника/источника данных.
	Close	Метод Close закрывает источник/приёмник данных.
	FieldsFromFile	Метод FieldsFromFile осуществляет чтение списка полей из файла-источника.
	Load	Метод Load загружает параметры источника/приёмника данных из XML.
	Open	Метод Open открывает источник/приёмник данных.
	Save	Метод Save сохраняет параметры источника/приёмника данных в формате XML.