Создает курсор, определяемый 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).
Примечания
Применяется к: классу 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.