System.IO.Compression.xml 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.IO.Compression</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.IO.Compression.CompressionLevel">
  8. <summary>指定值,這個值表示壓縮作業會強調速度還是壓縮大小。</summary>
  9. </member>
  10. <member name="F:System.IO.Compression.CompressionLevel.Fastest">
  11. <summary>即使不能有效壓縮所產生的檔案,應該儘速完成壓縮作業。</summary>
  12. </member>
  13. <member name="F:System.IO.Compression.CompressionLevel.NoCompression">
  14. <summary>不應該對檔案執行壓縮。</summary>
  15. </member>
  16. <member name="F:System.IO.Compression.CompressionLevel.Optimal">
  17. <summary>壓縮作業應該會進行最佳化壓縮,即使該作業耗費更長的時間才能完成。</summary>
  18. </member>
  19. <member name="T:System.IO.Compression.CompressionMode">
  20. <summary> 指定是要壓縮還是要解壓縮基礎資料流。</summary>
  21. </member>
  22. <member name="F:System.IO.Compression.CompressionMode.Compress">
  23. <summary>壓縮基礎資料流。</summary>
  24. </member>
  25. <member name="F:System.IO.Compression.CompressionMode.Decompress">
  26. <summary>解壓縮基礎資料流。</summary>
  27. </member>
  28. <member name="T:System.IO.Compression.DeflateStream">
  29. <summary>提供方法和屬性,以透過 Deflate 演算法來壓縮和解壓縮資料流。</summary>
  30. </member>
  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>
  38. </member>
  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>
  47. </member>
  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>
  56. </member>
  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>
  66. </member>
  67. <member name="P:System.IO.Compression.DeflateStream.BaseStream">
  68. <summary>取得基礎資料流的參考。</summary>
  69. <returns>資料流物件,表示基礎資料流。</returns>
  70. <exception cref="T:System.ObjectDisposedException">已關閉基礎資料流。</exception>
  71. </member>
  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>
  75. </member>
  76. <member name="P:System.IO.Compression.DeflateStream.CanSeek">
  77. <summary>取得值,指出資料流是否支援搜尋。</summary>
  78. <returns>所有情況下都是 false。</returns>
  79. </member>
  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>
  83. </member>
  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>
  87. </member>
  88. <member name="M:System.IO.Compression.DeflateStream.Flush">
  89. <summary>這個方法目前的實作沒有任何功能。</summary>
  90. <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
  91. <PermissionSet>
  92. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  93. </PermissionSet>
  94. </member>
  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>
  99. <PermissionSet>
  100. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  101. </PermissionSet>
  102. </member>
  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>
  107. <PermissionSet>
  108. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  109. </PermissionSet>
  110. </member>
  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>
  124. </member>
  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>
  131. </member>
  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>
  136. </member>
  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>
  143. </member>
  144. <member name="T:System.IO.Compression.GZipStream">
  145. <summary>提供用於壓縮和解壓縮資料流的方法和屬性。</summary>
  146. </member>
  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>
  154. </member>
  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>
  163. </member>
  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>
  172. </member>
  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>
  182. </member>
  183. <member name="P:System.IO.Compression.GZipStream.BaseStream">
  184. <summary>取得基礎資料流的參考。</summary>
  185. <returns>資料流物件,表示基礎資料流。</returns>
  186. <exception cref="T:System.ObjectDisposedException">已關閉基礎資料流。</exception>
  187. <PermissionSet>
  188. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  189. </PermissionSet>
  190. </member>
  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>
  194. <PermissionSet>
  195. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  196. </PermissionSet>
  197. </member>
  198. <member name="P:System.IO.Compression.GZipStream.CanSeek">
  199. <summary>取得值,指出資料流是否支援搜尋。</summary>
  200. <returns>所有情況下都是 false。</returns>
  201. </member>
  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>
  205. <PermissionSet>
  206. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  207. </PermissionSet>
  208. </member>
  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>
  212. </member>
  213. <member name="M:System.IO.Compression.GZipStream.Flush">
  214. <summary>這個方法目前的實作沒有任何功能。</summary>
  215. <exception cref="T:System.ObjectDisposedException">已關閉資料流。</exception>
  216. <PermissionSet>
  217. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  218. </PermissionSet>
  219. </member>
  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>
  224. <PermissionSet>
  225. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  226. </PermissionSet>
  227. </member>
  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>
  232. <PermissionSet>
  233. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  234. </PermissionSet>
  235. </member>
  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>
  249. </member>
  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>
  256. </member>
  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>
  261. </member>
  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>
  269. </member>
  270. <member name="T:System.IO.Compression.ZipArchive">
  271. <summary>代表 zip 封存格式的壓縮檔封裝。</summary>
  272. </member>
  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>
  280. </member>
  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>
  291. </member>
  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>
  303. </member>
  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>
  316. </member>
  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>
  327. </member>
  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>
  339. </member>
  340. <member name="M:System.IO.Compression.ZipArchive.Dispose">
  341. <summary>將 <see cref="T:System.IO.Compression.ZipArchive" /> 類別目前的執行個體所使用的資源釋出。</summary>
  342. </member>
  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>
  346. </member>
  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>
  353. </member>
  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>
  365. </member>
  366. <member name="P:System.IO.Compression.ZipArchive.Mode">
  367. <summary>取得值,描述 zip 封存可以在項目上執行的動作類型。</summary>
  368. <returns>其中一個列舉值,其描述 zip 封存可以在項目上執行的動作類型 (讀取、建立或更新)。</returns>
  369. </member>
  370. <member name="T:System.IO.Compression.ZipArchiveEntry">
  371. <summary>表示 zip 封存中的壓縮檔。</summary>
  372. </member>
  373. <member name="P:System.IO.Compression.ZipArchiveEntry.Archive">
  374. <summary>取得項目所屬的 zip 封存。</summary>
  375. <returns>項目所屬的 Zip 封存,如果已刪除項目,則為 null。</returns>
  376. </member>
  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>
  381. </member>
  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>
  387. </member>
  388. <member name="P:System.IO.Compression.ZipArchiveEntry.FullName">
  389. <summary>取得 Zip 封存中的項目相對路徑。</summary>
  390. <returns>Zip 封存中的項目相對路徑。</returns>
  391. </member>
  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>
  398. </member>
  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>
  403. </member>
  404. <member name="P:System.IO.Compression.ZipArchiveEntry.Name">
  405. <summary>取得 Zip 封存中的項目檔名。</summary>
  406. <returns>Zip 封存中的項目檔名。</returns>
  407. </member>
  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>
  414. </member>
  415. <member name="M:System.IO.Compression.ZipArchiveEntry.ToString">
  416. <summary>擷取 Zip 封存中項目的相對路徑。</summary>
  417. <returns>項目的相對路徑,其為儲存在 <see cref="P:System.IO.Compression.ZipArchiveEntry.FullName" /> 屬性中的值。</returns>
  418. </member>
  419. <member name="T:System.IO.Compression.ZipArchiveMode">
  420. <summary>指定與 zip 封存項目互動的值。</summary>
  421. </member>
  422. <member name="F:System.IO.Compression.ZipArchiveMode.Create">
  423. <summary>僅允許建立新的封存項目。</summary>
  424. </member>
  425. <member name="F:System.IO.Compression.ZipArchiveMode.Read">
  426. <summary>僅允許讀取封存項目。</summary>
  427. </member>
  428. <member name="F:System.IO.Compression.ZipArchiveMode.Update">
  429. <summary>封存項目允許讀取及寫入作業。</summary>
  430. </member>
  431. </members>
  432. </doc>