Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.
 
 
 
 
 
 

276 рядки
36 KiB

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.IO.Compression.ZipFile</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.IO.Compression.ZipFile">
  8. <summary>Provides static methods for creating, extracting, and opening zip archives. </summary>
  9. </member>
  10. <member name="M:System.IO.Compression.ZipFile.CreateFromDirectory(System.String,System.String)">
  11. <summary>Creates a zip archive that contains the files and directories from the specified directory.</summary>
  12. <param name="sourceDirectoryName">The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  13. <param name="destinationArchiveFileName">The path of the archive to be created, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  14. <exception cref="T:System.ArgumentException">
  15. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  16. <exception cref="T:System.ArgumentNullException">
  17. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is null.</exception>
  18. <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  19. <exception cref="T:System.IO.DirectoryNotFoundException">
  20. <paramref name="sourceDirectoryName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  21. <exception cref="T:System.IO.IOException">
  22. <paramref name="destinationArchiveFileName" /> already exists.-or-A file in the specified directory could not be opened.</exception>
  23. <exception cref="T:System.UnauthorizedAccessException">
  24. <paramref name="destinationArchiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName" /> or the file specified in <paramref name="destinationArchiveFileName" />.</exception>
  25. <exception cref="T:System.NotSupportedException">
  26. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> contains an invalid format.-or-The zip archive does not support writing.</exception>
  27. </member>
  28. <member name="M:System.IO.Compression.ZipFile.CreateFromDirectory(System.String,System.String,System.IO.Compression.CompressionLevel,System.Boolean)">
  29. <summary>Creates a zip archive that contains the files and directories from the specified directory, uses the specified compression level, and optionally includes the base directory.</summary>
  30. <param name="sourceDirectoryName">The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  31. <param name="destinationArchiveFileName">The path of the archive to be created, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  32. <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
  33. <param name="includeBaseDirectory">true to include the directory name from <paramref name="sourceDirectoryName" /> at the root of the archive; false to include only the contents of the directory.</param>
  34. <exception cref="T:System.ArgumentException">
  35. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  36. <exception cref="T:System.ArgumentNullException">
  37. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is null.</exception>
  38. <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  39. <exception cref="T:System.IO.DirectoryNotFoundException">
  40. <paramref name="sourceDirectoryName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  41. <exception cref="T:System.IO.IOException">
  42. <paramref name="destinationArchiveFileName" /> already exists.-or-A file in the specified directory could not be opened.</exception>
  43. <exception cref="T:System.UnauthorizedAccessException">
  44. <paramref name="destinationArchiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName" /> or the file specified in <paramref name="destinationArchiveFileName" />.</exception>
  45. <exception cref="T:System.NotSupportedException">
  46. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> contains an invalid format.-or-The zip archive does not support writing.</exception>
  47. </member>
  48. <member name="M:System.IO.Compression.ZipFile.CreateFromDirectory(System.String,System.String,System.IO.Compression.CompressionLevel,System.Boolean,System.Text.Encoding)">
  49. <summary>Creates a zip archive that contains the files and directories from the specified directory, uses the specified compression level and character encoding for entry names, and optionally includes the base directory.</summary>
  50. <param name="sourceDirectoryName">The path to the directory to be archived, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  51. <param name="destinationArchiveFileName">The path of the archive to be created, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  52. <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
  53. <param name="includeBaseDirectory">true to include the directory name from <paramref name="sourceDirectoryName" /> at the root of the archive; false to include only the contents of the directory.</param>
  54. <param name="entryNameEncoding">The encoding to use when reading or writing entry names in this archive. 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.</param>
  55. <exception cref="T:System.ArgumentException">
  56. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-<paramref name="entryNameEncoding" /> is set to a Unicode encoding other than UTF-8.</exception>
  57. <exception cref="T:System.ArgumentNullException">
  58. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> is null.</exception>
  59. <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  60. <exception cref="T:System.IO.DirectoryNotFoundException">
  61. <paramref name="sourceDirectoryName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  62. <exception cref="T:System.IO.IOException">
  63. <paramref name="destinationArchiveFileName" /> already exists.-or-A file in the specified directory could not be opened.</exception>
  64. <exception cref="T:System.UnauthorizedAccessException">
  65. <paramref name="destinationArchiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName" /> or the file specified in <paramref name="destinationArchiveFileName" />.</exception>
  66. <exception cref="T:System.NotSupportedException">
  67. <paramref name="sourceDirectoryName" /> or <paramref name="destinationArchiveFileName" /> contains an invalid format.-or-The zip archive does not support writing.</exception>
  68. </member>
  69. <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String)">
  70. <summary>Extracts all the files in the specified zip archive to a directory on the file system.</summary>
  71. <param name="sourceArchiveFileName">The path to the archive that is to be extracted.</param>
  72. <param name="destinationDirectoryName">The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  73. <exception cref="T:System.ArgumentException">
  74. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  75. <exception cref="T:System.ArgumentNullException">
  76. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> is null.</exception>
  77. <exception cref="T:System.IO.PathTooLongException">The specified path in <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  78. <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
  79. <exception cref="T:System.IO.IOException">The directory specified by <paramref name="destinationDirectoryName" /> already exists.-or-The name of an entry in the archive is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-Extracting an archive entry would create a file that is outside the directory specified by <paramref name="destinationDirectoryName" />. (For example, this might happen if the entry name contains parent directory accessors.) -or-An archive entry to extract has the same name as an entry that has already been extracted from the same archive.</exception>
  80. <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the archive or the destination directory.</exception>
  81. <exception cref="T:System.NotSupportedException">
  82. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> contains an invalid format.</exception>
  83. <exception cref="T:System.IO.FileNotFoundException">
  84. <paramref name="sourceArchiveFileName" /> was not found.</exception>
  85. <exception cref="T:System.IO.InvalidDataException">The archive specified by <paramref name="sourceArchiveFileName" /> is not a valid zip archive.-or-An archive entry was not found or was corrupt.-or-An archive entry was compressed by using a compression method that is not supported.</exception>
  86. </member>
  87. <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String,System.Text.Encoding)">
  88. <summary>Extracts all the files in the specified zip archive to a directory on the file system and uses the specified character encoding for entry names.</summary>
  89. <param name="sourceArchiveFileName">The path to the archive that is to be extracted.</param>
  90. <param name="destinationDirectoryName">The path to the directory in which to place the extracted files, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  91. <param name="entryNameEncoding">The encoding to use when reading or writing entry names in this archive. 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.</param>
  92. <exception cref="T:System.ArgumentException">
  93. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-<paramref name="entryNameEncoding" /> is set to a Unicode encoding other than UTF-8.</exception>
  94. <exception cref="T:System.ArgumentNullException">
  95. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> is null.</exception>
  96. <exception cref="T:System.IO.PathTooLongException">The specified path in <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  97. <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
  98. <exception cref="T:System.IO.IOException">The directory specified by <paramref name="destinationDirectoryName" /> already exists.-or-The name of an entry in the archive is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-Extracting an archive entry would create a file that is outside the directory specified by <paramref name="destinationDirectoryName" />. (For example, this might happen if the entry name contains parent directory accessors.) -or-An archive entry to extract has the same name as an entry that has already been extracted from the same archive.</exception>
  99. <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the archive or the destination directory.</exception>
  100. <exception cref="T:System.NotSupportedException">
  101. <paramref name="destinationDirectoryName" /> or <paramref name="sourceArchiveFileName" /> contains an invalid format.</exception>
  102. <exception cref="T:System.IO.FileNotFoundException">
  103. <paramref name="sourceArchiveFileName" /> was not found.</exception>
  104. <exception cref="T:System.IO.InvalidDataException">The archive specified by <paramref name="sourceArchiveFileName" /> is not a valid zip archive.-or-An archive entry was not found or was corrupt.-or-An archive entry was compressed by using a compression method that is not supported.</exception>
  105. </member>
  106. <member name="M:System.IO.Compression.ZipFile.Open(System.String,System.IO.Compression.ZipArchiveMode)">
  107. <summary>Opens a zip archive at the specified path and in the specified mode.</summary>
  108. <returns>The opened zip archive.</returns>
  109. <param name="archiveFileName">The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  110. <param name="mode">One of the enumeration values that specifies the actions which are allowed on the entries in the opened archive.</param>
  111. <exception cref="T:System.ArgumentException">
  112. <paramref name="archiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  113. <exception cref="T:System.ArgumentNullException">
  114. <paramref name="archiveFileName" /> is null.</exception>
  115. <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  116. <exception cref="T:System.IO.DirectoryNotFoundException">
  117. <paramref name="archiveFileName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  118. <exception cref="T:System.IO.IOException">
  119. <paramref name="archiveFileName" /> could not be opened.-or-<paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.</exception>
  120. <exception cref="T:System.UnauthorizedAccessException">
  121. <paramref name="archiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the file specified in <paramref name="archiveFileName" />.</exception>
  122. <exception cref="T:System.ArgumentOutOfRangeException">
  123. <paramref name="mode" /> specifies an invalid value.</exception>
  124. <exception cref="T:System.IO.FileNotFoundException">
  125. <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Read" />, but the file specified in <paramref name="archiveFileName" /> is not found.</exception>
  126. <exception cref="T:System.NotSupportedException">
  127. <paramref name="archiveFileName" /> contains an invalid format.</exception>
  128. <exception cref="T:System.IO.InvalidDataException">
  129. <paramref name="archiveFileName" /> could not be interpreted as a zip archive.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" />, but an entry is missing or corrupt and cannot be read.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" />, but an entry is too large to fit into memory.</exception>
  130. </member>
  131. <member name="M:System.IO.Compression.ZipFile.Open(System.String,System.IO.Compression.ZipArchiveMode,System.Text.Encoding)">
  132. <summary>Opens a zip archive at the specified path, in the specified mode, and by using the specified character encoding for entry names.</summary>
  133. <returns>The opened zip archive.</returns>
  134. <param name="archiveFileName">The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  135. <param name="mode">One of the enumeration values that specifies the actions that are allowed on the entries in the opened archive.</param>
  136. <param name="entryNameEncoding">The encoding to use when reading or writing entry names in this archive. 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.</param>
  137. <exception cref="T:System.ArgumentException">
  138. <paramref name="archiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-<paramref name="entryNameEncoding" /> is set to a Unicode encoding other than UTF-8.</exception>
  139. <exception cref="T:System.ArgumentNullException">
  140. <paramref name="archiveFileName" /> is null.</exception>
  141. <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  142. <exception cref="T:System.IO.DirectoryNotFoundException">
  143. <paramref name="archiveFileName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  144. <exception cref="T:System.IO.IOException">
  145. <paramref name="archiveFileName" /> could not be opened.-or-<paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.</exception>
  146. <exception cref="T:System.UnauthorizedAccessException">
  147. <paramref name="archiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the file specified in <paramref name="archiveFileName" />.</exception>
  148. <exception cref="T:System.ArgumentOutOfRangeException">
  149. <paramref name="mode" /> specifies an invalid value.</exception>
  150. <exception cref="T:System.IO.FileNotFoundException">
  151. <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Read" />, but the file specified in <paramref name="archiveFileName" /> is not found.</exception>
  152. <exception cref="T:System.NotSupportedException">
  153. <paramref name="archiveFileName" /> contains an invalid format.</exception>
  154. <exception cref="T:System.IO.InvalidDataException">
  155. <paramref name="archiveFileName" /> could not be interpreted as a zip archive.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" />, but an entry is missing or corrupt and cannot be read.-or-<paramref name="mode" /> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update" />, but an entry is too large to fit into memory.</exception>
  156. </member>
  157. <member name="M:System.IO.Compression.ZipFile.OpenRead(System.String)">
  158. <summary>Opens a zip archive for reading at the specified path.</summary>
  159. <returns>The opened zip archive.</returns>
  160. <param name="archiveFileName">The path to the archive to open, specified as a relative or absolute path. A relative path is interpreted as relative to the current working directory.</param>
  161. <exception cref="T:System.ArgumentException">
  162. <paramref name="archiveFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  163. <exception cref="T:System.ArgumentNullException">
  164. <paramref name="archiveFileName" /> is null.</exception>
  165. <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  166. <exception cref="T:System.IO.DirectoryNotFoundException">
  167. <paramref name="archiveFileName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
  168. <exception cref="T:System.IO.IOException">
  169. <paramref name="archiveFileName" /> could not be opened.</exception>
  170. <exception cref="T:System.UnauthorizedAccessException">
  171. <paramref name="archiveFileName" /> specifies a directory.-or-The caller does not have the required permission to access the file specified in <paramref name="archiveFileName" />.</exception>
  172. <exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="archiveFileName" /> is not found.</exception>
  173. <exception cref="T:System.NotSupportedException">
  174. <paramref name="archiveFileName" /> contains an invalid format.</exception>
  175. <exception cref="T:System.IO.InvalidDataException">
  176. <paramref name="archiveFileName" /> could not be interpreted as a zip archive.</exception>
  177. </member>
  178. <member name="T:System.IO.Compression.ZipFileExtensions">
  179. <summary>Provides extension methods for the <see cref="T:System.IO.Compression.ZipArchive" /> and <see cref="T:System.IO.Compression.ZipArchiveEntry" /> classes.</summary>
  180. </member>
  181. <member name="M:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile(System.IO.Compression.ZipArchive,System.String,System.String)">
  182. <summary>Archives a file by compressing it and adding it to the zip archive.</summary>
  183. <returns>A wrapper for the new entry in the zip archive.</returns>
  184. <param name="destination">The zip archive to add the file to.</param>
  185. <param name="sourceFileName">The path to the file to be archived. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.</param>
  186. <param name="entryName">The name of the entry to create in the zip archive.</param>
  187. <exception cref="T:System.ArgumentException">
  188. <paramref name="sourceFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-<paramref name="entryName" /> is <see cref="F:System.String.Empty" />.</exception>
  189. <exception cref="T:System.ArgumentNullException">
  190. <paramref name="sourceFileName" /> or <paramref name="entryName" /> is null.</exception>
  191. <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  192. <exception cref="T:System.IO.DirectoryNotFoundException">
  193. <paramref name="sourceFileName" /> is invalid (for example, it is on an unmapped drive).</exception>
  194. <exception cref="T:System.IO.IOException">The file specified by <paramref name="sourceFileName" /> cannot be opened.</exception>
  195. <exception cref="T:System.UnauthorizedAccessException">
  196. <paramref name="sourceFileName" /> specifies a directory.-or-The caller does not have the required permission to access the file specified by <paramref name="sourceFileName" />.</exception>
  197. <exception cref="T:System.IO.FileNotFoundException">The file specified by <paramref name="sourceFileName" /> is not found.</exception>
  198. <exception cref="T:System.NotSupportedException">The <paramref name="sourceFileName" /> parameter is in an invalid format.-or-The zip archive does not support writing.</exception>
  199. <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
  200. </member>
  201. <member name="M:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile(System.IO.Compression.ZipArchive,System.String,System.String,System.IO.Compression.CompressionLevel)">
  202. <summary>Archives a file by compressing it using the specified compression level and adding it to the zip archive.</summary>
  203. <returns>A wrapper for the new entry in the zip archive.</returns>
  204. <param name="destination">The zip archive to add the file to.</param>
  205. <param name="sourceFileName">The path to the file to be archived. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.</param>
  206. <param name="entryName">The name of the entry to create in the zip archive.</param>
  207. <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
  208. <exception cref="T:System.ArgumentException">
  209. <paramref name="sourceFileName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-<paramref name="entryName" /> is <see cref="F:System.String.Empty" />.</exception>
  210. <exception cref="T:System.ArgumentNullException">
  211. <paramref name="sourceFileName" /> or <paramref name="entryName" /> is null.</exception>
  212. <exception cref="T:System.IO.DirectoryNotFoundException">
  213. <paramref name="sourceFileName" /> is invalid (for example, it is on an unmapped drive).</exception>
  214. <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceFileName" />, the specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  215. <exception cref="T:System.IO.IOException">The file specified by <paramref name="sourceFileName" /> cannot be opened.</exception>
  216. <exception cref="T:System.UnauthorizedAccessException">
  217. <paramref name="sourceFileName" /> specifies a directory.-or-The caller does not have the required permission to access the file specified by <paramref name="sourceFileName" />.</exception>
  218. <exception cref="T:System.IO.FileNotFoundException">The file specified by <paramref name="sourceFileName" /> is not found.</exception>
  219. <exception cref="T:System.NotSupportedException">The <paramref name="sourceFileName" /> parameter is in an invalid format.-or-The zip archive does not support writing.</exception>
  220. <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
  221. </member>
  222. <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToDirectory(System.IO.Compression.ZipArchive,System.String)">
  223. <summary>Extracts all the files in the zip archive to a directory on the file system.</summary>
  224. <param name="source">The zip archive to extract files from.</param>
  225. <param name="destinationDirectoryName">The path to the directory to place the extracted files in. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.</param>
  226. <exception cref="T:System.ArgumentException">
  227. <paramref name="destinationDirectoryName" /> is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.</exception>
  228. <exception cref="T:System.ArgumentNullException">
  229. <paramref name="destinationDirectoryName" /> is null.</exception>
  230. <exception cref="T:System.IO.PathTooLongException">The specified path exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters.</exception>
  231. <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
  232. <exception cref="T:System.IO.IOException">The directory specified by <paramref name="destinationDirectoryName" /> already exists.-or-The name of an entry in the archive is <see cref="F:System.String.Empty" />, contains only white space, or contains at least one invalid character.-or-Extracting an entry from the archive would create a file that is outside the directory specified by <paramref name="destinationDirectoryName" />. (For example, this might happen if the entry name contains parent directory accessors.) -or-Two or more entries in the archive have the same name.</exception>
  233. <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to write to the destination directory.</exception>
  234. <exception cref="T:System.NotSupportedException">
  235. <paramref name="destinationDirectoryName" /> contains an invalid format.</exception>
  236. <exception cref="T:System.IO.InvalidDataException">An archive entry cannot be found or is corrupt.-or-An archive entry was compressed by using a compression method that is not supported.</exception>
  237. </member>
  238. <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToFile(System.IO.Compression.ZipArchiveEntry,System.String)">
  239. <summary>Extracts an entry in the zip archive to a file.</summary>
  240. <param name="source">The zip archive entry to extract a file from.</param>
  241. <param name="destinationFileName">The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.</param>
  242. <exception cref="T:System.ArgumentException">
  243. <paramref name="destinationFileName" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.-or-<paramref name="destinationFileName" /> specifies a directory.</exception>
  244. <exception cref="T:System.ArgumentNullException">
  245. <paramref name="destinationFileName" /> is null. </exception>
  246. <exception cref="T:System.IO.PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. </exception>
  247. <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive). </exception>
  248. <exception cref="T:System.IO.IOException">
  249. <paramref name="destinationFileName" /> already exists.-or- An I/O error occurred.-or-The entry is currently open for writing.-or-The entry has been deleted from the archive.</exception>
  250. <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to create the new file.</exception>
  251. <exception cref="T:System.IO.InvalidDataException">The entry is 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>
  252. <exception cref="T:System.ObjectDisposedException">The zip archive that this entry belongs to has been disposed.</exception>
  253. <exception cref="T:System.NotSupportedException">
  254. <paramref name="destinationFileName" /> is in an invalid format. -or-The zip archive for this entry was opened in <see cref="F:System.IO.Compression.ZipArchiveMode.Create" /> mode, which does not permit the retrieval of entries.</exception>
  255. </member>
  256. <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToFile(System.IO.Compression.ZipArchiveEntry,System.String,System.Boolean)">
  257. <summary>Extracts an entry in the zip archive to a file, and optionally overwrites an existing file that has the same name.</summary>
  258. <param name="source">The zip archive entry to extract a file from.</param>
  259. <param name="destinationFileName">The path of the file to create from the contents of the entry. You can specify either a relative or an absolute path. A relative path is interpreted as relative to the current working directory.</param>
  260. <param name="overwrite">true to overwrite an existing file that has the same name as the destination file; otherwise, false.</param>
  261. <exception cref="T:System.ArgumentException">
  262. <paramref name="destinationFileName" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.-or-<paramref name="destinationFileName" /> specifies a directory.</exception>
  263. <exception cref="T:System.ArgumentNullException">
  264. <paramref name="destinationFileName" /> is null. </exception>
  265. <exception cref="T:System.IO.PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must not exceed 248 characters, and file names must not exceed 260 characters. </exception>
  266. <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive). </exception>
  267. <exception cref="T:System.IO.IOException">
  268. <paramref name="destinationFileName" /> already exists and <paramref name="overwrite" /> is false.-or- An I/O error occurred.-or-The entry is currently open for writing.-or-The entry has been deleted from the archive.</exception>
  269. <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to create the new file.</exception>
  270. <exception cref="T:System.IO.InvalidDataException">The entry is 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>
  271. <exception cref="T:System.ObjectDisposedException">The zip archive that this entry belongs to has been disposed.</exception>
  272. <exception cref="T:System.NotSupportedException">
  273. <paramref name="destinationFileName" /> is in an invalid format. -or-The zip archive for this entry was opened in <see cref="F:System.IO.Compression.ZipArchiveMode.Create" /> mode, which does not permit the retrieval of entries.</exception>
  274. </member>
  275. </members>
  276. </doc>