Xceed Zip Compression Library Documentation
TextEncoding property
Xceed Zip control reference > Xceed Zip control properties > TextEncoding property

Description

The TextEncoding property allows you to specify the default text encoding that will be applied to files that are added to the zip file.

Data type

xcdTextEncoding

Possible values

Value Meaning
xteStandard The "OEM" text encoding will be used. It consists of ASCII characters. Non-ASCII characters will be encoded according to code page 437 or whatever your system defines as the OEM code page through the registry key HKLM\SYSTEM\CurrentControlSet\Control\Nls\CodePage\OEMCP.

This is the default encoding and is supported by all Zip utilities.

xteUnicode 8-bit Unicode text (UTF-8) will be used. This encoding appears as part of the Zip Specification 6.3.0. It might not be supported by every zip utility. In that case, you might get mangled filenames and file comments if they contain non-ASCII characters.

As of this writing, WinZip 12 uses this encoding as an option.

For maximum compatibility, use the xehUTF8Filename and xehUTF8Comment extra headers instead of this value. These headers will contain the same information, but they will be written as extra headers instead of being part of the main headers. As such, they will be safely ignored by zip utilities that don't support them.

Default value

xteStandard

Declaration (DLL API)  

UINT XzGetTextEncoding( HXCEEDZIP hZip )
void XzSetTextEncoding( HXCEEDZIP hZip, UINT uValue )

Remarks

This property doesn't apply when unzipping files. The library automatically detects the correct text encoding to use based on the headers inside the zip file.

This property determines which text encoding will be used in the main zip headers. As such, it doesn't affect the xehUnicode, xehUTF8Filename and xehUTF8Comment extra headers.

Applicable methods

Zip, Convert

See Also