ZipArchive コンストラクター

定義

ZipArchive クラスの新しいインスタンスを初期化します。Initializes a new instance of the ZipArchive class.

オーバーロード

ZipArchive(Stream)

指定したストリームから ZipArchive クラスの新しいインスタンスを初期化します。Initializes a new instance of the ZipArchive class from the specified stream.

ZipArchive(Stream, ZipArchiveMode)

指定したストリームと指定したモードから ZipArchive クラスの新しいインスタンスを初期化します。Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

ZipArchive(Stream, ZipArchiveMode, Boolean)

指定されたモードの指定されたストリームで ZipArchive クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, and optionally leaves the stream open.

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

指定されたモードの指定されたストリームで ZipArchive クラスの新しいインスタンスを初期化し、エントリ名に指定されたエンコーディングを使用します。また、必要に応じて、ストリームを開いたままにします。Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, uses the specified encoding for entry names, and optionally leaves the stream open.

ZipArchive(Stream)

指定したストリームから ZipArchive クラスの新しいインスタンスを初期化します。Initializes a new instance of the ZipArchive class from the specified stream.

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

読み取るアーカイブを格納しているストリーム。The stream that contains the archive to be read.

例外

ストリームが既に閉じているか、読み取りをサポートしていません。The stream is already closed or does not support reading.

streamnullです。stream is null.

ストリームの内容は zip アーカイブのフォームにありません。The contents of the stream are not in the zip archive format.

適用対象

ZipArchive(Stream, ZipArchiveMode)

指定したストリームと指定したモードから ZipArchive クラスの新しいインスタンスを初期化します。Initializes a new instance of the ZipArchive class from the specified stream and with the specified mode.

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

入力ストリームまたは出力ストリーム。The input or output stream.

mode
ZipArchiveMode

zip のアーカイブがエントリの読み込み、作成、または更新に使用されているかどうかを示す列挙値の 1 つ。One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

例外

ストリームは既に終了しているか、ストリームの機能がモードに一致しません。The stream is already closed, or the capabilities of the stream do not match the mode.

streamnullです。stream is null.

mode が無効な値です。mode is an invalid value.

ストリームの内容は zip のアーカイブとして解釈できません。The contents of the stream could not be interpreted as a zip archive.

- または --or- modeUpdate で、エントリがアーカイブにないか、または破損していて読み取ることができません。mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

- または --or- modeUpdate で、エントリが大きすぎてメモリに収まりません。mode is Update and an entry is too large to fit into memory.

注釈

modeパラメーターがに設定されている場合 Read 、ストリームは読み取りをサポートしている必要があります。If the mode parameter is set to Read, the stream must support reading. modeパラメーターがに設定されている場合 Create 、ストリームは書き込みをサポートしている必要があります。If the mode parameter is set to Create, the stream must support writing. modeパラメーターがに設定されている場合 Update 、ストリームは読み取り、書き込み、シークをサポートしている必要があります。If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

適用対象

ZipArchive(Stream, ZipArchiveMode, Boolean)

指定されたモードの指定されたストリームで ZipArchive クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, and optionally leaves the stream open.

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

入力ストリームまたは出力ストリーム。The input or output stream.

mode
ZipArchiveMode

zip のアーカイブがエントリの読み込み、作成、または更新に使用されているかどうかを示す列挙値の 1 つ。One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

ZipArchive オブジェクトを破棄した後にストリームを開いたままにする場合は true、それ以外の場合は falsetrue to leave the stream open after the ZipArchive object is disposed; otherwise, false.

例外

ストリームは既に終了しているか、ストリームの機能がモードに一致しません。The stream is already closed, or the capabilities of the stream do not match the mode.

streamnullです。stream is null.

mode が無効な値です。mode is an invalid value.

ストリームの内容は zip のアーカイブとして解釈できません。The contents of the stream could not be interpreted as a zip archive.

- または --or- modeUpdate で、エントリがアーカイブにないか、または破損していて読み取ることができません。mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

- または --or- modeUpdate で、エントリが大きすぎてメモリに収まりません。mode is Update and an entry is too large to fit into memory.

注釈

modeパラメーターがに設定されている場合 Read 、ストリームは読み取りをサポートしている必要があります。If the mode parameter is set to Read, the stream must support reading. modeパラメーターがに設定されている場合 Create 、ストリームは書き込みをサポートしている必要があります。If the mode parameter is set to Create, the stream must support writing. modeパラメーターがに設定されている場合 Update 、ストリームは読み取り、書き込み、シークをサポートしている必要があります。If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

適用対象

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

指定されたモードの指定されたストリームで ZipArchive クラスの新しいインスタンスを初期化し、エントリ名に指定されたエンコーディングを使用します。また、必要に応じて、ストリームを開いたままにします。Initializes a new instance of the ZipArchive class on the specified stream for the specified mode, uses the specified encoding for entry names, and optionally leaves the stream open.

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

入力ストリームまたは出力ストリーム。The input or output stream.

mode
ZipArchiveMode

zip のアーカイブがエントリの読み込み、作成、または更新に使用されているかどうかを示す列挙値の 1 つ。One of the enumeration values that indicates whether the zip archive is used to read, create, or update entries.

leaveOpen
Boolean

ZipArchive オブジェクトを破棄した後にストリームを開いたままにする場合は true、それ以外の場合は falsetrue to leave the stream open after the ZipArchive object is disposed; otherwise, false.

entryNameEncoding
Encoding

このアーカイブのエントリ名の読み取りまたは書き込み時に使用するエンコード。The encoding to use when reading or writing entry names in this archive. エントリ名の UTF-8 エンコードをサポートしない zip アーカイブ ツールとライブラリとの相互運用性のためにエンコードが必要な場合にのみ、このパラメーターの値を指定してください。Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names.

例外

ストリームは既に終了しているか、ストリームの機能がモードに一致しません。The stream is already closed, or the capabilities of the stream do not match the mode.

- または --or-

entryNameEncoding に対して UTF-8 以外のエンコードが指定されています。An encoding other than UTF-8 is specified for the entryNameEncoding.

streamnullです。stream is null.

mode が無効な値です。mode is an invalid value.

ストリームの内容は zip のアーカイブとして解釈できません。The contents of the stream could not be interpreted as a zip archive.

- または --or- modeUpdate で、エントリがアーカイブにないか、または破損していて読み取ることができません。mode is Update and an entry is missing from the archive or is corrupt and cannot be read.

- または --or- modeUpdate で、エントリが大きすぎてメモリに収まりません。mode is Update and an entry is too large to fit into memory.

注釈

modeパラメーターがに設定されている場合 Read 、ストリームは読み取りをサポートしている必要があります。If the mode parameter is set to Read, the stream must support reading. modeパラメーターがに設定されている場合 Create 、ストリームは書き込みをサポートしている必要があります。If the mode parameter is set to Create, the stream must support writing. modeパラメーターがに設定されている場合 Update 、ストリームは読み取り、書き込み、シークをサポートしている必要があります。If the mode parameter is set to Update, the stream must support reading, writing, and seeking.

Zip アーカイブファイルを読み取り用に開き、 entryNameEncoding をに設定すると null 、エントリ名は次の規則に従ってデコードされます。When you open a zip archive file for reading and entryNameEncoding is set to null, entry names 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.

  • 言語のエンコードフラグが設定されている場合は、UTF-8 を使用してエントリ名がデコードされます。When the language encoding flag is set, UTF-8 is used to decode the entry name.

読み取り用に zip アーカイブファイルを開いたときに entryNameEncoding 以外の値に設定されている場合 null 、エントリ名は次の規則に従ってデコードされます。When you open a zip archive file for reading and entryNameEncoding is set to a value other than null, entry names are decoded according to the following rules:

  • 言語のエンコードフラグが設定されていない場合は、指定されたを使用して entryNameEncoding エントリ名がデコードされます。When the language encoding flag is not set, the specified entryNameEncoding is used to decode the entry name.

  • 言語のエンコードフラグが設定されている場合は、UTF-8 を使用してエントリ名がデコードされます。When the language encoding flag is set, UTF-8 is used to decode the entry name.

アーカイブファイルに書き込み、 entryNameEncoding がに設定されている場合 null 、エントリ名は次の規則に従ってエンコードされます。When you write to archive files and entryNameEncoding is set to null, entry names are encoded according to the following rules:

  • ASCII の範囲外の文字を含むエントリ名の場合、言語エンコードフラグが設定され、エントリ名は UTF-8 を使用してエンコードされます。For entry names that contain characters outside the ASCII range, the language encoding flag is set, and entry names are encoded by using UTF-8.

  • ASCII 文字のみを含むエントリ名の場合、言語エンコードフラグは設定されず、エントリ名は、現在のシステムの既定のコードページを使用してエンコードされます。For entry names that contain only ASCII characters, the language encoding flag is not set, and entry names are encoded by using the current system default code page.

アーカイブファイルに書き込み、が以外の値に設定されている場合、指定されたは entryNameEncoding null entryNameEncoding エントリ名をバイトにエンコードするために使用されます。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 into bytes. 言語エンコードフラグ (ローカルファイルヘッダーの汎用ビットフラグ) は、指定されたエンコードが UTF-8 エンコーディングの場合にのみ設定されます。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.

適用対象