1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.IO.Compression</name>
7 <member name="T:System.IO.Compression.CompressionLevel">
8 <summary>指定值,這個值表示壓縮作業會強調速度還是壓縮大小。</summary>
10 <member name="F:System.IO.Compression.CompressionLevel.Fastest">
11 <summary>即使不能有效壓縮所產生的檔案,應該儘速完成壓縮作業。</summary>
13 <member name="F:System.IO.Compression.CompressionLevel.NoCompression">
14 <summary>不應該對檔案執行壓縮。</summary>
16 <member name="F:System.IO.Compression.CompressionLevel.Optimal">
17 <summary>壓縮作業應該會進行最佳化壓縮,即使該作業耗費更長的時間才能完成。</summary>
19 <member name="T:System.IO.Compression.CompressionMode">
20 <summary> 指定是要壓縮還是要解壓縮基礎資料流。</summary>
22 <member name="F:System.IO.Compression.CompressionMode.Compress">
23 <summary>壓縮基礎資料流。</summary>
25 <member name="F:System.IO.Compression.CompressionMode.Decompress">
26 <summary>解壓縮基礎資料流。</summary>
28 <member name="T:System.IO.Compression.DeflateStream">
29 <summary>提供方法和屬性,以透過 Deflate 演算法來壓縮和解壓縮資料流。</summary>
31 <member name="M:System.IO.Compression.DeflateStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionLevel)">
32 <summary>使用指定的資料流和壓縮層級,初始化 <see cref="T:System.IO.Compression.DeflateStream" /> 類別的新執行個體。</summary>
33 <param name="stream">要壓縮的資料流。</param>
34 <param name="compressionLevel">其中一個列舉值,指出當壓縮資料流時是否要強調速度或壓縮的效益。</param>
35 <exception cref="T:System.ArgumentNullException">
36 <paramref name="stream" /> 為 null。</exception>
37 <exception cref="T:System.ArgumentException">資料流不支援寫入作業,例如壓縮。(資料流物件上的 <see cref="P:System.IO.Stream.CanWrite" />屬性是false)。</exception>
39 <member name="M:System.IO.Compression.DeflateStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionLevel,System.Boolean)">
40 <summary>使用指定的資料流和壓縮層級,初始化 <see cref="T:System.IO.Compression.DeflateStream" /> 類別的新執行個體,並選擇性地保持開啟資料流。</summary>
41 <param name="stream">要壓縮的資料流。</param>
42 <param name="compressionLevel">其中一個列舉值,指出當壓縮資料流時是否要強調速度或壓縮的效益。</param>
43 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.DeflateStream" /> 物件之後,將資料流物件保持開啟;否則為 false。</param>
44 <exception cref="T:System.ArgumentNullException">
45 <paramref name="stream" /> 為 null。</exception>
46 <exception cref="T:System.ArgumentException">資料流不支援寫入作業,例如壓縮。(資料流物件上的 <see cref="P:System.IO.Stream.CanWrite" />屬性是false)。</exception>
48 <member name="M:System.IO.Compression.DeflateStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionMode)">
49 <summary>使用指定的資料流和壓縮模式,初始化 <see cref="T:System.IO.Compression.DeflateStream" /> 類別的新執行個體。</summary>
50 <param name="stream">要壓縮或解壓縮的資料流。</param>
51 <param name="mode">其中一個列舉值,表示要壓縮還是解壓縮資料流。</param>
52 <exception cref="T:System.ArgumentNullException">
53 <paramref name="stream" /> 為 null。</exception>
54 <exception cref="T:System.ArgumentException">
55 <paramref name="mode" /> 不是有效的 <see cref="T:System.IO.Compression.CompressionMode" /> 值。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Compress" />,而 <see cref="P:System.IO.Stream.CanWrite" /> 是 false。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Decompress" />,而 <see cref="P:System.IO.Stream.CanRead" /> 是 false。</exception>
57 <member name="M:System.IO.Compression.DeflateStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionMode,System.Boolean)">
58 <summary>使用指定的資料流和壓縮模式,初始化 <see cref="T:System.IO.Compression.DeflateStream" /> 類別的新執行個體,並選擇性地保持開啟資料流。</summary>
59 <param name="stream">要壓縮或解壓縮的資料流。</param>
60 <param name="mode">其中一個列舉值,表示要壓縮還是解壓縮資料流。</param>
61 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.DeflateStream" /> 物件之後,將資料流保持開啟;否則為 false。</param>
62 <exception cref="T:System.ArgumentNullException">
63 <paramref name="stream" /> 為 null。</exception>
64 <exception cref="T:System.ArgumentException">
65 <paramref name="mode" /> 不是有效的 <see cref="T:System.IO.Compression.CompressionMode" /> 值。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Compress" />,而 <see cref="P:System.IO.Stream.CanWrite" /> 是 false。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Decompress" />,而 <see cref="P:System.IO.Stream.CanRead" /> 是 false。</exception>
67 <member name="P:System.IO.Compression.DeflateStream.BaseStream">
68 <summary>取得基礎資料流的參考。</summary>
69 <returns>資料流物件,表示基礎資料流。</returns>
70 <exception cref="T:System.ObjectDisposedException">已關閉基礎資料流。</exception>
72 <member name="P:System.IO.Compression.DeflateStream.CanRead">
73 <summary>取得值,指出在解壓縮檔案時,資料流是否支援讀取。</summary>
74 <returns>如果 <see cref="T:System.IO.Compression.CompressionMode" /> 值為 Decompress,且基礎資料流處於開啟狀態並支援讀取,則為 true;否則為 false。</returns>
76 <member name="P:System.IO.Compression.DeflateStream.CanSeek">
77 <summary>取得值,指出資料流是否支援搜尋。</summary>
78 <returns>所有情況下都是 false。</returns>
80 <member name="P:System.IO.Compression.DeflateStream.CanWrite">
81 <summary>取得值,指出資料流是否支援寫入。</summary>
82 <returns>如果 <see cref="T:System.IO.Compression.CompressionMode" /> 值為 Compress,並且基礎資料流支援寫入,且不處於關閉狀態,則為 true;否則為 false。</returns>
84 <member name="M:System.IO.Compression.DeflateStream.Dispose(System.Boolean)">
85 <summary>釋放 <see cref="T:System.IO.Compression.DeflateStream" /> 所使用的 Unmanaged 資源,並選擇性釋放 Managed 資源。</summary>
86 <param name="disposing">true 表示釋放 Managed 和 Unmanaged 資源,false 則表示只釋放 Unmanaged 資源。</param>
88 <member name="M:System.IO.Compression.DeflateStream.Flush">
89 <summary>這個方法目前的實作沒有任何功能。</summary>
90 <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
92 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
95 <member name="P:System.IO.Compression.DeflateStream.Length">
96 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
97 <returns>長整數值。</returns>
98 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
100 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
103 <member name="P:System.IO.Compression.DeflateStream.Position">
104 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
105 <returns>長整數值。</returns>
106 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
108 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
111 <member name="M:System.IO.Compression.DeflateStream.Read(System.Byte[],System.Int32,System.Int32)">
112 <summary>將大量解壓縮的位元組讀入指定的位元組陣列。</summary>
113 <returns>已讀入至位元組陣列的位元組數。</returns>
114 <param name="array">用於儲存解壓縮位元組的陣列。</param>
115 <param name="offset">要在其中放置讀取位元組之 <paramref name="array" /> 的位元組位移。</param>
116 <param name="count">要讀取的最大解壓縮位元組數。</param>
117 <exception cref="T:System.ArgumentNullException">
118 <paramref name="array" /> 為 null。</exception>
119 <exception cref="T:System.InvalidOperationException">建立物件時,<see cref="T:System.IO.Compression.CompressionMode" /> 的值為 Compress。-或- 基礎資料流不支援讀取。</exception>
120 <exception cref="T:System.ArgumentOutOfRangeException">
121 <paramref name="offset" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="array" /> 長度減去索引起點小於 <paramref name="count" />。</exception>
122 <exception cref="T:System.IO.InvalidDataException">資料的格式無效。</exception>
123 <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
125 <member name="M:System.IO.Compression.DeflateStream.Seek(System.Int64,System.IO.SeekOrigin)">
126 <summary>這個作業不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
127 <returns>長整數值。</returns>
128 <param name="offset">在資料流中的位置。</param>
129 <param name="origin">其中一個 <see cref="T:System.IO.SeekOrigin" /> 值。</param>
130 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
132 <member name="M:System.IO.Compression.DeflateStream.SetLength(System.Int64)">
133 <summary>這個作業不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
134 <param name="value">資料流的長度。</param>
135 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
137 <member name="M:System.IO.Compression.DeflateStream.Write(System.Byte[],System.Int32,System.Int32)">
138 <summary>從指定的位元組陣列將壓縮的位元組寫入基礎資料流。</summary>
139 <param name="array">包含要壓縮之資料的緩衝區。</param>
140 <param name="offset">
141 <paramref name="array" /> 中的位元組位移,即讀取位元組的來源位置。</param>
142 <param name="count">寫入的最大位元組數。</param>
144 <member name="T:System.IO.Compression.GZipStream">
145 <summary>提供用於壓縮和解壓縮資料流的方法和屬性。</summary>
147 <member name="M:System.IO.Compression.GZipStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionLevel)">
148 <summary>使用指定的資料流和壓縮層級,初始化 <see cref="T:System.IO.Compression.GZipStream" /> 類別的新執行個體。</summary>
149 <param name="stream">要寫入壓縮資料的資料流。</param>
150 <param name="compressionLevel">其中一個列舉值,指出當壓縮資料流時是否要強調速度或壓縮的效益。</param>
151 <exception cref="T:System.ArgumentNullException">
152 <paramref name="stream" /> 為 null。</exception>
153 <exception cref="T:System.ArgumentException">資料流不支援寫入作業,例如壓縮。(資料流物件上的 <see cref="P:System.IO.Stream.CanWrite" />屬性是false)。</exception>
155 <member name="M:System.IO.Compression.GZipStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionLevel,System.Boolean)">
156 <summary>使用指定的資料流和壓縮層級,初始化 <see cref="T:System.IO.Compression.GZipStream" /> 類別的新執行個體,並選擇性地保持開啟資料流。</summary>
157 <param name="stream">要寫入壓縮資料的資料流。</param>
158 <param name="compressionLevel">其中一個列舉值,指出當壓縮資料流時是否要強調速度或壓縮的效益。</param>
159 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.GZipStream" /> 物件之後,將資料流物件保持開啟;否則為 false。</param>
160 <exception cref="T:System.ArgumentNullException">
161 <paramref name="stream" /> 為 null。</exception>
162 <exception cref="T:System.ArgumentException">資料流不支援寫入作業,例如壓縮。(資料流物件上的 <see cref="P:System.IO.Stream.CanWrite" />屬性是false)。</exception>
164 <member name="M:System.IO.Compression.GZipStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionMode)">
165 <summary>使用指定的資料流和壓縮模式,初始化 <see cref="T:System.IO.Compression.GZipStream" /> 類別的新執行個體。</summary>
166 <param name="stream">寫入壓縮或解壓縮資料的資料流。</param>
167 <param name="mode">其中一個列舉值,表示要壓縮還是解壓縮資料流。</param>
168 <exception cref="T:System.ArgumentNullException">
169 <paramref name="stream" /> 為 null。</exception>
170 <exception cref="T:System.ArgumentException">
171 <paramref name="mode" /> 不是有效的 <see cref="T:System.IO.Compression.CompressionMode" /> 列舉值。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Compress" />,而 <see cref="P:System.IO.Stream.CanWrite" /> 是 false。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Decompress" />,而 <see cref="P:System.IO.Stream.CanRead" /> 是 false。</exception>
173 <member name="M:System.IO.Compression.GZipStream.#ctor(System.IO.Stream,System.IO.Compression.CompressionMode,System.Boolean)">
174 <summary>使用指定的資料流和壓縮模式,初始化 <see cref="T:System.IO.Compression.GZipStream" /> 類別的新執行個體,並選擇性地保持開啟資料流。</summary>
175 <param name="stream">寫入壓縮或解壓縮資料的資料流。</param>
176 <param name="mode">其中一個列舉值,表示要壓縮還是解壓縮資料流。</param>
177 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.GZipStream" /> 物件之後,將資料流保持開啟;否則為 false。</param>
178 <exception cref="T:System.ArgumentNullException">
179 <paramref name="stream" /> 為 null。</exception>
180 <exception cref="T:System.ArgumentException">
181 <paramref name="mode" /> 不是有效的 <see cref="T:System.IO.Compression.CompressionMode" /> 值。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Compress" />,而 <see cref="P:System.IO.Stream.CanWrite" /> 是 false。-或-<see cref="T:System.IO.Compression.CompressionMode" /> 是 <see cref="F:System.IO.Compression.CompressionMode.Decompress" />,而 <see cref="P:System.IO.Stream.CanRead" /> 是 false。</exception>
183 <member name="P:System.IO.Compression.GZipStream.BaseStream">
184 <summary>取得基礎資料流的參考。</summary>
185 <returns>資料流物件,表示基礎資料流。</returns>
186 <exception cref="T:System.ObjectDisposedException">已關閉基礎資料流。</exception>
188 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
191 <member name="P:System.IO.Compression.GZipStream.CanRead">
192 <summary>取得值,指出在解壓縮檔案時,資料流是否支援讀取。</summary>
193 <returns>如果 <see cref="T:System.IO.Compression.CompressionMode" /> 值為 Decompress,,並且基礎資料流支援讀取,且不處於關閉狀態,則為 true;否則為 false。</returns>
195 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
198 <member name="P:System.IO.Compression.GZipStream.CanSeek">
199 <summary>取得值,指出資料流是否支援搜尋。</summary>
200 <returns>所有情況下都是 false。</returns>
202 <member name="P:System.IO.Compression.GZipStream.CanWrite">
203 <summary>取得值,指出資料流是否支援寫入。</summary>
204 <returns>如果 <see cref="T:System.IO.Compression.CompressionMode" /> 值為 Compress,並且基礎資料流支援寫入,且不處於關閉狀態,則為 true;否則為 false。</returns>
206 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
209 <member name="M:System.IO.Compression.GZipStream.Dispose(System.Boolean)">
210 <summary>釋放 <see cref="T:System.IO.Compression.GZipStream" /> 所使用的 Unmanaged 資源,並選擇性釋放 Managed 資源。</summary>
211 <param name="disposing">true 表示釋放 Managed 和 Unmanaged 資源,false 則表示只釋放 Unmanaged 資源。</param>
213 <member name="M:System.IO.Compression.GZipStream.Flush">
214 <summary>這個方法目前的實作沒有任何功能。</summary>
215 <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
217 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
220 <member name="P:System.IO.Compression.GZipStream.Length">
221 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
222 <returns>長整數值。</returns>
223 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
225 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
228 <member name="P:System.IO.Compression.GZipStream.Position">
229 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
230 <returns>長整數值。</returns>
231 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
233 <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
236 <member name="M:System.IO.Compression.GZipStream.Read(System.Byte[],System.Int32,System.Int32)">
237 <summary>將大量解壓縮的位元組讀入指定的位元組陣列。</summary>
238 <returns>解壓縮至位元組陣列的位元組數。如果已達到資料流的結尾,則會傳回零或位元組數。</returns>
239 <param name="array">用於儲存解壓縮位元組的陣列。</param>
240 <param name="offset">要在其中放置讀取位元組之 <paramref name="array" /> 的位元組位移。</param>
241 <param name="count">要讀取的最大解壓縮位元組數。</param>
242 <exception cref="T:System.ArgumentNullException">
243 <paramref name="array" /> 為 null。</exception>
244 <exception cref="T:System.InvalidOperationException">建立物件時,<see cref="T:System.IO.Compression.CompressionMode" /> 的值為 Compress。-或-基礎資料流不支援讀取。</exception>
245 <exception cref="T:System.ArgumentOutOfRangeException">
246 <paramref name="offset" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="array" /> 長度減去索引起點小於 <paramref name="count" />。</exception>
247 <exception cref="T:System.IO.InvalidDataException">資料的格式無效。</exception>
248 <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
250 <member name="M:System.IO.Compression.GZipStream.Seek(System.Int64,System.IO.SeekOrigin)">
251 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
252 <returns>長整數值。</returns>
253 <param name="offset">在資料流中的位置。</param>
254 <param name="origin">其中一個 <see cref="T:System.IO.SeekOrigin" /> 值。</param>
255 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
257 <member name="M:System.IO.Compression.GZipStream.SetLength(System.Int64)">
258 <summary>這個屬性不受支援,而且一律會擲回 <see cref="T:System.NotSupportedException" />。</summary>
259 <param name="value">資料流的長度。</param>
260 <exception cref="T:System.NotSupportedException">這個資料流不支援這個屬性。</exception>
262 <member name="M:System.IO.Compression.GZipStream.Write(System.Byte[],System.Int32,System.Int32)">
263 <summary>從指定的位元組陣列將壓縮的位元組寫入基礎資料流。</summary>
264 <param name="array">包含要壓縮之資料的緩衝區。</param>
265 <param name="offset">
266 <paramref name="array" /> 中的位元組位移,即讀取位元組的來源位置。</param>
267 <param name="count">寫入的最大位元組數。</param>
268 <exception cref="T:System.ObjectDisposedException">無法執行寫入作業,因為資料流已關閉。</exception>
270 <member name="T:System.IO.Compression.ZipArchive">
271 <summary>代表 zip 封存格式的壓縮檔封裝。</summary>
273 <member name="M:System.IO.Compression.ZipArchive.#ctor(System.IO.Stream)">
274 <summary>從指定的資料流,初始化 <see cref="T:System.IO.Compression.ZipArchive" /> 類別的新執行個體。</summary>
275 <param name="stream">包含要讀取之封存的資料流。</param>
276 <exception cref="T:System.ArgumentException">The stream is already closed or does not support reading.</exception>
277 <exception cref="T:System.ArgumentNullException">
278 <paramref name="stream" /> is null.</exception>
279 <exception cref="T:System.IO.InvalidDataException">The contents of the stream are not in the zip archive format.</exception>
281 <member name="M:System.IO.Compression.ZipArchive.#ctor(System.IO.Stream,System.IO.Compression.ZipArchiveMode)">
282 <summary>使用指定的模式,從指定的資料流初始化 <see cref="T:System.IO.Compression.ZipArchive" /> 類別的新執行個體。</summary>
283 <param name="stream">輸入或輸出資料流。</param>
284 <param name="mode">其中一個列舉值,指出是否使用 zip 封存讀取、建立或更新項目。</param>
285 <exception cref="T:System.ArgumentException">The stream is already closed, or the capabilities of the stream do not match the mode.</exception>
286 <exception cref="T:System.ArgumentNullException">
287 <paramref name="stream" /> is null.</exception>
288 <exception cref="T:System.ArgumentOutOfRangeException">
289 <paramref name="mode" /> is an invalid value.</exception>
290 <exception cref="T:System.IO.InvalidDataException">The contents of the stream could not be interpreted as a zip archive.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is missing from the archive or is corrupt and cannot be read.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is too large to fit into memory.</exception>
292 <member name="M:System.IO.Compression.ZipArchive.#ctor(System.IO.Stream,System.IO.Compression.ZipArchiveMode,System.Boolean)">
293 <summary>在指定之模式的指定資料流上,初始化 <see cref="T:System.IO.Compression.ZipArchive" /> 類別的新執行個體,並選擇性地保留資料流開啟狀態。</summary>
294 <param name="stream">輸入或輸出資料流。</param>
295 <param name="mode">其中一個列舉值,指出是否使用 zip 封存讀取、建立或更新項目。</param>
296 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.ZipArchive" /> 物件之後,將資料流保持開啟,否則為 false。</param>
297 <exception cref="T:System.ArgumentException">The stream is already closed, or the capabilities of the stream do not match the mode.</exception>
298 <exception cref="T:System.ArgumentNullException">
299 <paramref name="stream" /> is null.</exception>
300 <exception cref="T:System.ArgumentOutOfRangeException">
301 <paramref name="mode" /> is an invalid value.</exception>
302 <exception cref="T:System.IO.InvalidDataException">The contents of the stream could not be interpreted as a zip archive.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is missing from the archive or is corrupt and cannot be read.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is too large to fit into memory.</exception>
304 <member name="M:System.IO.Compression.ZipArchive.#ctor(System.IO.Stream,System.IO.Compression.ZipArchiveMode,System.Boolean,System.Text.Encoding)">
305 <summary>在指定模式的指定資料流上,初始化 <see cref="T:System.IO.Compression.ZipArchive" /> 類別的新執行個體,使用項目名稱的指定編碼方式,並選擇性地保留資料流開啟狀態。</summary>
306 <param name="stream">輸入或輸出資料流。</param>
307 <param name="mode">其中一個列舉值,指出是否使用 zip 封存讀取、建立或更新項目。</param>
308 <param name="leaveOpen">true 表示在處置 <see cref="T:System.IO.Compression.ZipArchive" /> 物件之後,將資料流保持開啟,否則為 false。</param>
309 <param name="entryNameEncoding">在此封存中讀取或寫入項目名稱時要使用的編碼方式。只有需要編碼以與 Zip 封存工具和程式庫互通,且這類工具和程式庫不支援項目名稱使用 UTF-8 編碼時,才指定此參數的值。</param>
310 <exception cref="T:System.ArgumentException">The stream is already closed, or the capabilities of the stream do not match the mode.</exception>
311 <exception cref="T:System.ArgumentNullException">
312 <paramref name="stream" /> is null.</exception>
313 <exception cref="T:System.ArgumentOutOfRangeException">
314 <paramref name="mode" /> is an invalid value.</exception>
315 <exception cref="T:System.IO.InvalidDataException">The contents of the stream could not be interpreted as a zip archive.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is missing from the archive or is corrupt and cannot be read.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and an entry is too large to fit into memory.</exception>
317 <member name="M:System.IO.Compression.ZipArchive.CreateEntry(System.String)">
318 <summary>在 zip 封存中建立具有指定之路徑和項目名稱的空項目。</summary>
319 <returns>Zip 封存中的空項目。</returns>
320 <param name="entryName">指定要建立之項目名稱的路徑 (相對於封存的根目錄)。</param>
321 <exception cref="T:System.ArgumentException">
322 <paramref name="entryName" /> is <see cref="F:System.String.Empty" />.</exception>
323 <exception cref="T:System.ArgumentNullException">
324 <paramref name="entryName" /> is null.</exception>
325 <exception cref="T:System.NotSupportedException">The zip archive does not support writing.</exception>
326 <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
328 <member name="M:System.IO.Compression.ZipArchive.CreateEntry(System.String,System.IO.Compression.CompressionLevel)">
329 <summary>在 zip 封存中建立具有指定之項目名稱和壓縮等級的空項目。</summary>
330 <returns>Zip 封存中的空項目。</returns>
331 <param name="entryName">指定要建立之項目名稱的路徑 (相對於封存的根目錄)。</param>
332 <param name="compressionLevel">其中一個列舉值,指出建立項目時是否要強調速度或壓縮的效益。</param>
333 <exception cref="T:System.ArgumentException">
334 <paramref name="entryName" /> is <see cref="F:System.String.Empty" />.</exception>
335 <exception cref="T:System.ArgumentNullException">
336 <paramref name="entryName" /> is null.</exception>
337 <exception cref="T:System.NotSupportedException">The zip archive does not support writing.</exception>
338 <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
340 <member name="M:System.IO.Compression.ZipArchive.Dispose">
341 <summary>將 <see cref="T:System.IO.Compression.ZipArchive" /> 類別目前的執行個體所使用的資源釋出。</summary>
343 <member name="M:System.IO.Compression.ZipArchive.Dispose(System.Boolean)">
344 <summary>由 <see cref="M:System.IO.Compression.ZipArchive.Dispose" /> 和 <see cref="M:System.Object.Finalize" /> 方法呼叫以釋放 <see cref="T:System.IO.Compression.ZipArchive" /> 類別之目前執行個體所使用的 Unmanaged 資源,並選擇性完成封存的寫入以及釋放 Managed 資源。</summary>
345 <param name="disposing">true 表示完成寫入封存並釋放 Managed 和 Unmanaged 資源,false 表示只釋放 Unmanaged 資源。</param>
347 <member name="P:System.IO.Compression.ZipArchive.Entries">
348 <summary>取得目前 zip 封存中所包含項目的集合。</summary>
349 <returns>目前 zip 封存中所包含項目的集合。</returns>
350 <exception cref="T:System.NotSupportedException">The zip archive does not support reading.</exception>
351 <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
352 <exception cref="T:System.IO.InvalidDataException">The zip archive is corrupt, and its entries cannot be retrieved.</exception>
354 <member name="M:System.IO.Compression.ZipArchive.GetEntry(System.String)">
355 <summary>在 zip 封存中擷取指定項目的包裝函式。</summary>
356 <returns>封存中指定項目的包裝函式,如果項目不存在於封存中則為 null。</returns>
357 <param name="entryName">識別要擷取之項目的路徑 (相對於封存的根目錄)。</param>
358 <exception cref="T:System.ArgumentException">
359 <paramref name="entryName" /> is <see cref="F:System.String.Empty" />.</exception>
360 <exception cref="T:System.ArgumentNullException">
361 <paramref name="entryName" /> is null.</exception>
362 <exception cref="T:System.NotSupportedException">The zip archive does not support reading.</exception>
363 <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
364 <exception cref="T:System.IO.InvalidDataException">The zip archive is corrupt, and its entries cannot be retrieved.</exception>
366 <member name="P:System.IO.Compression.ZipArchive.Mode">
367 <summary>取得值,描述 zip 封存可以在項目上執行的動作類型。</summary>
368 <returns>其中一個列舉值,其描述 zip 封存可以在項目上執行的動作類型 (讀取、建立或更新)。</returns>
370 <member name="T:System.IO.Compression.ZipArchiveEntry">
371 <summary>表示 zip 封存中的壓縮檔。</summary>
373 <member name="P:System.IO.Compression.ZipArchiveEntry.Archive">
374 <summary>取得項目所屬的 zip 封存。</summary>
375 <returns>項目所屬的 Zip 封存,如果已刪除項目,則為 null。</returns>
377 <member name="P:System.IO.Compression.ZipArchiveEntry.CompressedLength">
378 <summary>取得 Zip 封存中的項目壓縮大小。</summary>
379 <returns>Zip 封存中項目的壓縮大小。</returns>
380 <exception cref="T:System.InvalidOperationException">The value of the property is not available because the entry has been modified.</exception>
382 <member name="M:System.IO.Compression.ZipArchiveEntry.Delete">
383 <summary>從 zip 封存中刪除項目。</summary>
384 <exception cref="T:System.IO.IOException">The entry is already open for reading or writing.</exception>
385 <exception cref="T:System.NotSupportedException">The zip archive for this entry was opened in a mode other than <see cref="F:System.IO.Compression.ZipArchiveMode.Update" />. </exception>
386 <exception cref="T:System.ObjectDisposedException">The zip archive for this entry has been disposed.</exception>
388 <member name="P:System.IO.Compression.ZipArchiveEntry.FullName">
389 <summary>取得 Zip 封存中的項目相對路徑。</summary>
390 <returns>Zip 封存中的項目相對路徑。</returns>
392 <member name="P:System.IO.Compression.ZipArchiveEntry.LastWriteTime">
393 <summary>取得或設定上次變更 zip 封存中之項目的時間。</summary>
394 <returns>上次變更 zip 封存中之項目的時間。</returns>
395 <exception cref="T:System.NotSupportedException">The attempt to set this property failed, because the zip archive for the entry is in <see cref="F:System.IO.Compression.ZipArchiveMode.Read" /> mode.</exception>
396 <exception cref="T:System.IO.IOException">The archive mode is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />.- or -The archive mode is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Update" /> and the entry has been opened.</exception>
397 <exception cref="T:System.ArgumentOutOfRangeException">An attempt was made to set this property to a value that is either earlier than 1980 January 1 0:00:00 (midnight) or later than 2107 December 31 23:59:58 (one second before midnight).</exception>
399 <member name="P:System.IO.Compression.ZipArchiveEntry.Length">
400 <summary>取得 Zip 封存中的項目未壓縮大小。</summary>
401 <returns>Zip 封存中的項目未壓縮大小。</returns>
402 <exception cref="T:System.InvalidOperationException">The value of the property is not available because the entry has been modified.</exception>
404 <member name="P:System.IO.Compression.ZipArchiveEntry.Name">
405 <summary>取得 Zip 封存中的項目檔名。</summary>
406 <returns>Zip 封存中的項目檔名。</returns>
408 <member name="M:System.IO.Compression.ZipArchiveEntry.Open">
409 <summary>從 zip 封存中開啟項目。</summary>
410 <returns>代表此項目內容的資料流。</returns>
411 <exception cref="T:System.IO.IOException">The entry is already currently open for writing.-or-The entry has been deleted from the archive.-or-The archive for this entry was opened with the <see cref="F:System.IO.Compression.ZipArchiveMode.Create" /> mode, and this entry has already been written to. </exception>
412 <exception cref="T:System.IO.InvalidDataException">The entry is either missing from the archive or is corrupt and cannot be read. -or-The entry has been compressed by using a compression method that is not supported.</exception>
413 <exception cref="T:System.ObjectDisposedException">The zip archive for this entry has been disposed.</exception>
415 <member name="M:System.IO.Compression.ZipArchiveEntry.ToString">
416 <summary>擷取 Zip 封存中項目的相對路徑。</summary>
417 <returns>項目的相對路徑,其為儲存在 <see cref="P:System.IO.Compression.ZipArchiveEntry.FullName" /> 屬性中的值。</returns>
419 <member name="T:System.IO.Compression.ZipArchiveMode">
420 <summary>指定與 zip 封存項目互動的值。</summary>
422 <member name="F:System.IO.Compression.ZipArchiveMode.Create">
423 <summary>僅允許建立新的封存項目。</summary>
425 <member name="F:System.IO.Compression.ZipArchiveMode.Read">
426 <summary>僅允許讀取封存項目。</summary>
428 <member name="F:System.IO.Compression.ZipArchiveMode.Update">
429 <summary>封存項目允許讀取及寫入作業。</summary>