Определяет - должен ли объекта XMLAdapter использовать специальную логику для опрделения - какая кодовая страница должна быть использована кодирования или декодирования данных. Редактируемое (Read/write) в design и run time.

XMLAdapter.UseCodePage = lValue

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

lValue

Логический тип данных. В приведенной ниже таблице перечислены значения для lValue.

lValue Описание

False (.F.)

(Используется по умолчанию). В таблице, приведенной далее в тексте описаны последствия установки свойства UseCodePage в значение False (.F.).

True (.T.)

В таблице, приведенной далее в тексте описаны последствия установки свойства UseCodePage в значение True (.T.).

Примечания

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

При установке свойства UseCodePage объекта XMLAdapter в True (.T.), поведение методов ToCursor, ChangesToCursor и ApplyDiffgram изменяется следующим образом:

  • В случае, если методу не посылается параметр nCodePage, то для нового курсора в качестве кодовой страницы будет использована кодовая страница, определенная в свойстве CodePage объекта XMLTable (или кодоовая страница XMLAdapter если кодовая таблица для XMLTable установлена в нуль.

  • Когда заполняется поле, то для декодирования данных из Unicode использутся кодовая страница, определяемая значением свойства CodePage объкута XMLField (елси оно равно нулю, то используется кодовая страница курсора).

В приведенной ниже таблице показано - как влияют установки свойств UseCodePage, RespectCursorCP и UTF8Encoded на поведение метода ToXML.

RespectCursorCP UTF8Encoded UseCodePage=.F. UseCodePage=.T.

False (.F.)

False (.F.)

В качестве аттрибута трансляции XML документа используется кодовая страница Windows 1252.

Символьные данные транслируются в текущую кодовую страницу, используемую по умолчанию, за исключением полей, маркированных, как NOCPTRANS. Данные в Unicode транслируются с использованием кодовой страницы Windows 1252.

Идентично для UseCodePage = .F.

True (.T.)

False (.F.)

В качестве аттрибута трансляции XML документа используется кодовая страница курсора.

Символьные данные не транслируются и используются необработанные данные из таблицы. Данные в Unicode транслируются с использованием кодовой страницы курсора.

Идентично для UseCodePage = .F.

Однако, если значение XMLField CodePage больше нуля, но не совпадает с кодовой страницей курсора, то будет сгенерарована ошибка.

False (.F.)

True (.T.)

Как аттрибут декодирования XML документа используется кодовая страница UTF-8.

Символьные данные транслируется в кодовую страницу по умолчанию, за исключением полей, маркированных как NOCPTRANS и не производится дополнительной трансляции символов в кодовую страницу UTF-8. Данные в Unicode кодировке транслируются с использованием кодовой страницы UTF-8.

Идентично для UseCodePage = .F.

True (.T.)

True (.T.)

Как аттрибут декодирования XML документа используется кодовая страница UTF-8.

Символьные данные транслируется в кодовую страницу по умолчанию, за исключением полей, маркированных как NOCPTRANS. Эти поля транслируется в UTF-8 с использованием кодовой страницы, определяемой с помощью SYS(3005) - Set Locale ID. Данные в Unicode кодировке транслируются с использованием кодовой страницы UTF-8.

При трансляции аттрибутов XML документа используется кодовая страница UTF-8. Необработанные символьные данные из таблицы транслируются в кодовую страницу UTF-8, используя либо кодовую страницу курсора, либо кодовую страницу XMLField если она определена, то есть ее значение больше, чем нуль. Данные в Unicode кодировке транслируются с использованием кодовой страницы UTF-8.

Смотри также