Skip to content

.ctor_Stream_ZipArchiveMode_Boolean_Encoding.md

Latest commit

 

History

History
18 lines (11 loc) · 2.02 KB

.ctor_Stream_ZipArchiveMode_Boolean_Encoding.md

File metadata and controls

18 lines (11 loc) · 2.02 KB
Raw

If the mode parameter is set to xref:System.IO.Compression.ZipArchiveMode.Read, the stream must support reading. If the mode parameter is set to xref:System.IO.Compression.ZipArchiveMode.Create, the stream must support writing. If the mode parameter is set to xref:System.IO.Compression.ZipArchiveMode.Update, the stream must support reading, writing, and seeking.

When you open a zip archive file for reading and entryNameEncoding is set to null, entry names and comments are decoded according to the following rules:

  • When the language encoding flag (in the general-purpose bit flag of the local file header) is not set, the current system default code page is used to decode the entry name and comment.
  • When the language encoding flag is set, UTF-8 is used to decode the entry name and comment.

When you open a zip archive file for reading and entryNameEncoding is set to a value other than null, entry names and comments are decoded according to the following rules:

  • When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name and comment.
  • When the language encoding flag is set, UTF-8 is used to decode the entry name and comment.

When you write to archive files and entryNameEncoding is set to null, entry names and comments are encoded according to the following rules:

  • For entry names and comments that contain characters outside the ASCII range, the language encoding flag is set, and entry names and comments are encoded by using UTF-8.
  • For entry names and comments that contain only ASCII characters, the language encoding flag is not set, and entry names and comments are encoded by using the current system default code page.

When you write to archive files and entryNameEncoding is set to a value other than null, the specified entryNameEncoding is used to encode the entry names and comments into bytes. The language encoding flag (in the general-purpose bit flag of the local file header) is set only when the specified encoding is a UTF-8 encoding.