Share via


UTF8Encoded Property

Specifies whether to set encoding to Unicode Transformation Format-8 (UTF-8). UTF8Encoded works in conjunction with the RespectCursorCP property.

UTF8Encoded applies only when executing the XMLAdapterToXML method, which creates XML consistent with its setting.

XMLAdapter.UTF8Encoded [= lValue] 

Property Values

  • lValue
    Logical data type. The following table lists the values for lValue.
    lValue Description
    False (.F.) Does not set encoding to UTF-8. (Default)
    True (.T.) Sets encoding to UTF-8.

Remarks

The default encoding for XML is UTF-8, whereas for Visual FoxPro, the default encoding is Windows-1252. When you want to output data to XML, you can preserve UTF-8 encoding by setting encoding to UTF-8 and instructing Visual FoxPro to translate double-byte characters to the proper UTF-8 encoding sequence.

If you have a group of characters representing Korean or Chinese text, you can convert those characters to double-byte character sets (DBCS) to view them in Visual FoxPro. You can then reconvert them to UTF-8 when transmitting them across the Web as XML so that other systems can correctly display the data.

For example, the following table describes how RespectCursorCP and UTF8Encoded interact with each other.

RespectCursorCP UTF8Encoded Conversion performed
False False Windows-1252 (Default)
True False Set output encoding attribute to the code page of the cursor.
False True Set output encoding attribute to UTF-8. No character translation occurs.
True True Set output encoding attribute to UTF-8. Translate character data to UTF-8.
True False Set output encoding attribute to the code page of the cursor.

See Also

Properties | XMLAdapter Object Properties, Methods, and Events | RespectCursorCP Property | ToXML Method

Applies To: XMLAdapter Class