Создает курсор, определяемый XMLTable с полями, описанными в коллекции XMLTable Fields и загружает его данными из XML документа, на который имеется ссылка в объекте XMLAdapter.

ToCursor поддерживается только для объектов XMLTable, существующих в коллекции  Tables объекта XMLAdapter.

XMLTable.ToCursor( [ lAppend [, cAlias [, nCodePage ]]] )

Параметры

lAppend

Определяет - будут ли добавляться данные или записи в существующий курсор, указанный в параметре cAlias. В приведенно ниже таблице перечисленны возможные значения для lAppend и описываются действия, связанные с этим значениями .

lAppend Описание

False (.F.)

(По умолчанию) Не добавляет поля в существующий курсор.

True. (.T.)

Добавляет поля в существующий курсор.

cAlias

Указывает псевдоимя (alias) целевого курсора. В случае, когда псевдоимя не задано, то есть cAlias является пустой строкой (""), значение cAlias определяется по умолчанию значением свойства XMLTableAlias.

nCodePage

Указывает кодовую страницу. По умолчанию значение устанавливается равным  нулю (0).

Expand imageПримечания

Применяется к: классу XMLTable

Если свойство XMLField Alias не заполнено, метод ToCursor объекта XMLTable сбрасывает объекты XMLField и создает курсор, который не включает в себя никаких полей, указанных этими объектами XMLField.

Значение параметрв nCodePage должно присутствовать в списке поддерживаемых кодовых страниц. Если параметру nCodePage был передан нуль (0) и свойство UseCodePage установлено в False (.F), то используется текущая кодовая страница. Для получения более подробной информации смотрите Кодовые страницы поддерживаемые Visual FoxPro и Свойство UseCodePage.

Когда вы используете метод ToCursor для добавления данных, Visual FoxPro добавляет пустую строку, если имя объекта XMLField не сопоставимо с какой-либо колонкой курсора.

При разметке бинарных полей в символные Character типы данных, Visual FoxPro заполняет все остающееся пустое пространство символами 0x00 (CHR(0) или нулями) после перкодировки.

Если свойство RespectNesting объекта XMLAdapter установлено в True (.T.), узед должен следовать в качестве дочернего узла  сразу после узла внешней таблицы. Если таблицы не вложены, узел должен следовать в качестве дочернего узла  сразу после узла XMLAdapter'а.

Метод ToCursor не будет выполнен успешно в случае, если свойство XMLAdapter.XMLNameIsXPath установлено в True (.T.) одновременно с установленным в True (.T.) свойством XMLAdapter.IsDiffgram.

Expand imageСмотрите также