Xceed Real-Time Zip for .NET Documentation
TextEncoding Enumeration


Xceed.Zip Assembly > Xceed.Zip Namespace : TextEncoding Enumeration
Value representing the text encoding used in the header of zipped file and folder items. The filename and comment fields are affected by this value.
Syntax
'Declaration
 
Public Enum TextEncoding 

   Inherits System.Enum

   Implements System.IComparableSystem.IConvertibleSystem.IFormattable 
'Usage
 
Dim instance As TextEncoding
Members
MemberDescription
Standard

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.

Unicode

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.

For better compatibility, use the ExtraHeader.UTF8Filename and ExtraHeader.UTF8Comment extra headers. These extra headers contain the same information but will be safely ignored by zip utilities that don't support them.

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

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

Inheritance Hierarchy

System.Object
   System.ValueType
      System.Enum
         Xceed.Zip.TextEncoding

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

Xceed.Zip Namespace
DefaultTextEncoding Property
ZippedFile.TextEncoding
ZippedFolder.TextEncoding
DefaultUnicodeUsagePolicy Property