TextEncoding Property (XMLports)

Specifies the text encoding format to use when you use an XMLport to export or import data as text.

Applies to



The TextEncoding property is only available when the Format Property (XMLports) of the XMLport is set to Fixed Text or Variable Text.


  • MS-DOS (default)

  • UTF-8

  • UTF-16

  • Windows

    For more information, see Text Encoding.


Text encoding is the process of transforming bytes of data into readable characters for users of a system or program. There are several industry text encoding formats and different systems support different formats. Internally, Dynamics NAV uses Unicode encoding. For exporting and importing data with an XMLport, Dynamics NAV supports MS-DOS, UTF-8, UTF-16, and Windows encoding formats.

You should set the TextEncoding property to the encoding format that is compatible with the system or program that you will be exporting to or importing from. The following sections describe the available text encoding formats.


You can also set the TextEncoding property in C/AL code. For example, if your XMLport can import or export different formats based on certain conditions, you can change the encoding on the fly depending on the conditions. For example, you can write code such as the following:



The following code example illustrates how you can set the encoding during run time.

      CASE MyDefinitionTable."File Encoding" OF  
        MyDefinitionTable."File Encoding"::"MS-DOS":  
        MyDefinitionTable."File Encoding"::"UTF-8":  
        MyDefinitionTable."File Encoding"::"UTF-16":  
        MyDefinitionTable."File Encoding"::WINDOWS:  

The code example is based on XMLport 1220 in the CRONUS International Ltd. demonstration database. The table, MyDefinitionTable, has a field, File Encoding, that specifies the encoding for this part of an import.

See Also

How to: Create XMLports
Format Property (XMLports)
Walkthrough: Importing Data from Text Files to Tables
Text Encoding