ZipArchive コンストラクター

定義

名前空間:
System.IO.Compression
アセンブリ:
System.IO.Compression.dll
アセンブリ:
netstandard.dll

ZipArchive クラスの新しいインスタンスを初期化します。

オーバーロード

名前 説明
ZipArchive(Stream)

指定したストリームから ZipArchive クラスの新しいインスタンスを初期化します。
ZipArchive(Stream, ZipArchiveMode)

指定したストリームから、指定したモードを使用して、 ZipArchive クラスの新しいインスタンスを初期化します。
ZipArchive(Stream, ZipArchiveMode, Boolean)

指定したモードの指定したストリームで ZipArchive クラスの新しいインスタンスを初期化し、必要に応じてストリームを開いたままにします。
ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

指定したモードの指定したストリームで ZipArchive クラスの新しいインスタンスを初期化し、エントリ名に指定したエンコードを使用し、必要に応じてストリームを開いたままにします。

ZipArchive(Stream)

指定したストリームから 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

読み取るアーカイブを含むストリーム。

例外

ArgumentException

ストリームは既に閉じているか、読み取りをサポートしていません。

ArgumentNullException

stream は nullです。

InvalidDataException

ストリームの内容は zip アーカイブ形式ではありません。

適用対象

ZipArchive(Stream, ZipArchiveMode)

指定したストリームから、指定したモードを使用して、 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 アーカイブを使用するかどうかを示す列挙値の 1 つ。

例外

ArgumentException

ストリームが既に閉じているか、ストリームの機能がモードと一致しません。

ArgumentNullException

stream は nullです。

ArgumentOutOfRangeException

mode が無効な値です。

InvalidDataException

ストリームの内容を zip アーカイブとして解釈できませんでした。

-または-

mode が Update され、エントリがアーカイブに存在しないか、破損しているため、読み取ることができません。

-または-

mode が Update であり、エントリが大きすぎてメモリに収まらない。

注釈

mode パラメーターが Read に設定されている場合、ストリームは読み取りをサポートする必要があります。 mode パラメーターが Create に設定されている場合、ストリームは書き込みをサポートする必要があります。 mode パラメーターが Update に設定されている場合、ストリームは読み取り、書き込み、シークをサポートする必要があります。

適用対象

ZipArchive(Stream, ZipArchiveMode, Boolean)

指定したモードの指定したストリームで 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 アーカイブを使用するかどうかを示す列挙値の 1 つ。

leaveOpen
Boolean

true ZipArchive オブジェクトが破棄された後にストリームを開いたままにする場合は。それ以外の場合はfalse。

例外

ArgumentException

ストリームが既に閉じているか、ストリームの機能がモードと一致しません。

ArgumentNullException

stream は nullです。

ArgumentOutOfRangeException

mode が無効な値です。

InvalidDataException

ストリームの内容を zip アーカイブとして解釈できませんでした。

-または-

mode が Update され、エントリがアーカイブに存在しないか、破損しているため、読み取ることができません。

-または-

mode が Update であり、エントリが大きすぎてメモリに収まらない。

注釈

mode パラメーターが Read に設定されている場合、ストリームは読み取りをサポートする必要があります。 mode パラメーターが Create に設定されている場合、ストリームは書き込みをサポートする必要があります。 mode パラメーターが Update に設定されている場合、ストリームは読み取り、書き込み、シークをサポートする必要があります。

適用対象

ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding)

指定したモードの指定したストリームで 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);
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 アーカイブを使用するかどうかを示す列挙値の 1 つ。

leaveOpen
Boolean

true ZipArchive オブジェクトが破棄された後にストリームを開いたままにする場合は。それ以外の場合はfalse。

entryNameEncoding
Encoding

このアーカイブ内のエントリ名とコメントを読み書きするときに使用するエンコード。 このパラメーターの値は、エントリ名またはコメントに UTF-8 エンコードをサポートしていない zip アーカイブ ツールおよびライブラリとの相互運用性にエンコードが必要な場合にのみ指定します。

例外

ArgumentException

ストリームが既に閉じているか、ストリームの機能がモードと一致しません。

-または-

entryNameEncodingには UTF-8 以外のエンコードが指定されています。

ArgumentNullException

stream は nullです。

ArgumentOutOfRangeException

mode が無効な値です。

InvalidDataException

ストリームの内容を 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 エンコードの場合にのみ設定されます。

適用対象