ZipArchive Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса ZipArchive.
Перегрузки
| Имя | Описание |
|---|---|
| ZipArchive(Stream) |
Инициализирует новый экземпляр класса из указанного ZipArchive потока. |
| ZipArchive(Stream, ZipArchiveMode) |
Инициализирует новый экземпляр класса из указанного ZipArchive потока и с указанным режимом. |
| ZipArchive(Stream, ZipArchiveMode, Boolean) |
Инициализирует новый экземпляр ZipArchive класса в указанном потоке для указанного режима и при необходимости оставляет поток открытым. |
| ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding) |
Инициализирует новый экземпляр ZipArchive класса в указанном потоке для указанного режима, использует указанную кодировку для имен записей и при необходимости оставляет поток открытым. |
ZipArchive(Stream)
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
Инициализирует новый экземпляр класса из указанного ZipArchive потока.
public:
ZipArchive(System::IO::Stream ^ stream);
public ZipArchive(System.IO.Stream stream);
new System.IO.Compression.ZipArchive : System.IO.Stream -> System.IO.Compression.ZipArchive
Public Sub New (stream As Stream)
Параметры
- stream
- Stream
Поток, содержащий архив для чтения.
Исключения
Поток уже закрыт или не поддерживает чтение.
stream равно null.
Содержимое потока не в формате ZIP-архива.
Применяется к
ZipArchive(Stream, ZipArchiveMode)
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
Инициализирует новый экземпляр класса из указанного ZipArchive потока и с указанным режимом.
public:
ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode);
public ZipArchive(System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode -> System.IO.Compression.ZipArchive
Public Sub New (stream As Stream, mode As ZipArchiveMode)
Параметры
- stream
- Stream
Входной или выходной поток.
- mode
- ZipArchiveMode
Одно из значений перечисления, указывающее, используется ли ZIP-архив для чтения, создания или обновления записей.
Исключения
Поток уже закрыт, или возможности потока не соответствуют режиму.
stream равно null.
mode является недопустимым значением.
Содержимое потока не может быть интерпретировано как zip-архив.
–или–
mode имеет Update значение и запись отсутствует в архиве или повреждена и не может быть прочитана.
–или–
mode имеет Update значение и запись слишком велика, чтобы поместиться в память.
Комментарии
mode Если для параметра задано значениеRead, поток должен поддерживать чтение.
mode Если для параметра задано значениеCreate, поток должен поддерживать запись.
mode Если для параметра задано значениеUpdate, поток должен поддерживать чтение, запись и поиск.
Применяется к
ZipArchive(Stream, ZipArchiveMode, Boolean)
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
Инициализирует новый экземпляр ZipArchive класса в указанном потоке для указанного режима и при необходимости оставляет поток открытым.
public:
ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode, bool leaveOpen);
public ZipArchive(System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool -> System.IO.Compression.ZipArchive
Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean)
Параметры
- stream
- Stream
Входной или выходной поток.
- mode
- ZipArchiveMode
Одно из значений перечисления, указывающее, используется ли ZIP-архив для чтения, создания или обновления записей.
- leaveOpen
- Boolean
trueЗначение , ZipArchiveчтобы оставить поток открытым после false удаления объекта; в противном случае .
Исключения
Поток уже закрыт, или возможности потока не соответствуют режиму.
stream равно null.
mode является недопустимым значением.
Содержимое потока не может быть интерпретировано как zip-архив.
–или–
mode имеет Update значение и запись отсутствует в архиве или повреждена и не может быть прочитана.
–или–
mode имеет Update значение и запись слишком велика, чтобы поместиться в память.
Комментарии
mode Если для параметра задано значениеRead, поток должен поддерживать чтение.
mode Если для параметра задано значениеCreate, поток должен поддерживать запись.
mode Если для параметра задано значениеUpdate, поток должен поддерживать чтение, запись и поиск.
Применяется к
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
- Исходный код:
- ZipArchive.cs
Инициализирует новый экземпляр ZipArchive класса в указанном потоке для указанного режима, использует указанную кодировку для имен записей и при необходимости оставляет поток открытым.
public:
ZipArchive(System::IO::Stream ^ stream, System::IO::Compression::ZipArchiveMode mode, bool leaveOpen, System::Text::Encoding ^ entryNameEncoding);
public ZipArchive(System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen, System.Text.Encoding entryNameEncoding);
public ZipArchive(System.IO.Stream stream, System.IO.Compression.ZipArchiveMode mode, bool leaveOpen, System.Text.Encoding? entryNameEncoding);
new System.IO.Compression.ZipArchive : System.IO.Stream * System.IO.Compression.ZipArchiveMode * bool * System.Text.Encoding -> System.IO.Compression.ZipArchive
Public Sub New (stream As Stream, mode As ZipArchiveMode, leaveOpen As Boolean, entryNameEncoding As Encoding)
Параметры
- stream
- Stream
Входной или выходной поток.
- mode
- ZipArchiveMode
Одно из значений перечисления, указывающее, используется ли ZIP-архив для чтения, создания или обновления записей.
- leaveOpen
- Boolean
trueЗначение , ZipArchiveчтобы оставить поток открытым после false удаления объекта; в противном случае .
- entryNameEncoding
- Encoding
Кодировка, используемая при чтении или записи имен и комментариев в этом архиве. Укажите значение этого параметра, только если кодировка требуется для взаимодействия с средствами и библиотеками ZIP-архива, которые не поддерживают кодировку UTF-8 для имен записей или комментариев.
Исключения
Поток уже закрыт, или возможности потока не соответствуют режиму.
–или–
Для кодировки, отличной от UTF-8 entryNameEncoding.
stream равно null.
mode является недопустимым значением.
Содержимое потока не может быть интерпретировано как zip-архив.
–или–
mode имеет Update значение и запись отсутствует в архиве или повреждена и не может быть прочитана.
–или–
mode имеет Update значение и запись слишком велика, чтобы поместиться в память.
Комментарии
mode Если для параметра задано значениеRead, поток должен поддерживать чтение.
mode Если для параметра задано значениеCreate, поток должен поддерживать запись.
mode Если для параметра задано значениеUpdate, поток должен поддерживать чтение, запись и поиск.
При открытии ZIP-архивного файла для чтения и entryNameEncoding присвоения значениям nullимена записей и примечаний декодируются в соответствии со следующими правилами:
- Если флаг кодировки языка (в флаге бита общего назначения заголовка локального файла) не задан, текущая системная кодовая страница по умолчанию используется для декодировки имени и комментария записи.
- При установке флага кодировки языка UTF-8 используется для декодировки имени записи и комментариев.
При открытии ZIP-архивного файла для чтения и entryNameEncoding присвоение значения, отличного nullот имен записей и комментариев, декодируются в соответствии со следующими правилами:
- Если флаг кодировки языка не задан, указанный
entryNameEncodingиспользуется для декодировки имени записи и комментария. - При установке флага кодировки языка UTF-8 используется для декодировки имени записи и комментариев.
При записи в архивные файлы и entryNameEncoding имеет nullзначение , имена и комментарии записей кодируются в соответствии со следующими правилами:
- Для имен записей и комментариев, содержащих символы за пределами диапазона ASCII, задается флаг кодировки языка, а имена и примечания кодируются с помощью UTF-8.
- Для имен записей и комментариев, содержащих только символы ASCII, флаг кодировки языка не задан, а имена и примечания записей кодируются с помощью текущей системной кодовой страницы по умолчанию.
При записи в архивные файлы и entryNameEncoding имеет значение, отличное nullот значения, указанное entryNameEncoding используется для кодирования имен записей и комментариев в байтах. Флаг кодировки языка (в битовом флаге общего назначения заголовка локального файла) устанавливается только в том случае, если указанная кодировка является кодировкой UTF-8.