[Tizen] Add BuildTools 2.1.0-rc1-02804-05
[platform/upstream/coreclr.git] / Tools / dotnetcli / sdk / NuGetFallbackFolder / microsoft.netcore.app / 2.0.3 / ref / netcoreapp2.0 / System.IO.Compression.ZipFile.xml
1 <?xml version="1.0" encoding="utf-8"?><span>
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"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
15       <exception cref="T:System.ArgumentNullException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is null.</exception>
16       <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>, 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>
17       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
18       <exception cref="T:System.IO.IOException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> already exists.   -or-   A file in the specified directory could not be opened.</exception>
19       <exception cref="T:System.UnauthorizedAccessException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or the file specified in <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>.</exception>
20       <exception cref="T:System.NotSupportedException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> contains an invalid format.   -or-   The zip archive does not support writing.</exception>
21     </member>
22     <member name="M:System.IO.Compression.ZipFile.CreateFromDirectory(System.String,System.String,System.IO.Compression.CompressionLevel,System.Boolean)">
23       <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>
24       <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>
25       <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>
26       <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
27       <param name="includeBaseDirectory">true to include the directory name from sourceDirectoryName at the root of the archive; false to include only the contents of the directory.</param>
28       <exception cref="T:System.ArgumentException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
29       <exception cref="T:System.ArgumentNullException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is null.</exception>
30       <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>, 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>
31       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
32       <exception cref="T:System.IO.IOException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> already exists.   -or-   A file in the specified directory could not be opened.</exception>
33       <exception cref="T:System.UnauthorizedAccessException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or the file specified in <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>.</exception>
34       <exception cref="T:System.NotSupportedException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> contains an invalid format.   -or-   The zip archive does not support writing.</exception>
35     </member>
36     <member name="M:System.IO.Compression.ZipFile.CreateFromDirectory(System.String,System.String,System.IO.Compression.CompressionLevel,System.Boolean,System.Text.Encoding)">
37       <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>
38       <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>
39       <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>
40       <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
41       <param name="includeBaseDirectory">true to include the directory name from sourceDirectoryName at the root of the archive; false to include only the contents of the directory.</param>
42       <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>
43       <exception cref="T:System.ArgumentException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.   -or-  <paramref name="entryNameEncoding">entryNameEncoding</paramref> is set to a Unicode encoding other than UTF-8.</exception>
44       <exception cref="T:System.ArgumentNullException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> is null.</exception>
45       <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>, 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>
46       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
47       <exception cref="T:System.IO.IOException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> already exists.   -or-   A file in the specified directory could not be opened.</exception>
48       <exception cref="T:System.UnauthorizedAccessException"><paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the directory specified in <paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or the file specified in <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref>.</exception>
49       <exception cref="T:System.NotSupportedException"><paramref name="sourceDirectoryName">sourceDirectoryName</paramref> or <paramref name="destinationArchiveFileName">destinationArchiveFileName</paramref> contains an invalid format.   -or-   The zip archive does not support writing.</exception>
50     </member>
51     <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String)">
52       <summary>Extracts all the files in the specified zip archive to a directory on the file system.</summary>
53       <param name="sourceArchiveFileName">The path to the archive that is to be extracted.</param>
54       <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>
55       <exception cref="T:System.ArgumentException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
56       <exception cref="T:System.ArgumentNullException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> is null.</exception>
57       <exception cref="T:System.IO.PathTooLongException">The specified path in <paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> 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>
58       <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
59       <exception cref="T:System.IO.IOException">The directory specified by <paramref name="destinationDirectoryName">destinationDirectoryName</paramref> already exists.   -or-   The name of an entry in the archive is <see cref="F:System.String.Empty"></see>, 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">destinationDirectoryName</paramref>. (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>
60       <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the archive or the destination directory.</exception>
61       <exception cref="T:System.NotSupportedException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> contains an invalid format.</exception>
62       <exception cref="T:System.IO.FileNotFoundException"><paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> was not found.</exception>
63       <exception cref="T:System.IO.InvalidDataException">The archive specified by <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> 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>
64     </member>
65     <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String,System.Boolean)">
66       <param name="sourceArchiveFileName"></param>
67       <param name="destinationDirectoryName"></param>
68       <param name="overwriteFiles"></param>
69     </member>
70     <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String,System.Text.Encoding)">
71       <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>
72       <param name="sourceArchiveFileName">The path to the archive that is to be extracted.</param>
73       <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>
74       <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>
75       <exception cref="T:System.ArgumentException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.   -or-  <paramref name="entryNameEncoding">entryNameEncoding</paramref> is set to a Unicode encoding other than UTF-8.</exception>
76       <exception cref="T:System.ArgumentNullException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> is null.</exception>
77       <exception cref="T:System.IO.PathTooLongException">The specified path in <paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> 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">destinationDirectoryName</paramref> already exists.   -or-   The name of an entry in the archive is <see cref="F:System.String.Empty"></see>, 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">destinationDirectoryName</paramref>. (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"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> or <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> contains an invalid format.</exception>
82       <exception cref="T:System.IO.FileNotFoundException"><paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> was not found.</exception>
83       <exception cref="T:System.IO.InvalidDataException">The archive specified by <paramref name="sourceArchiveFileName">sourceArchiveFileName</paramref> 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>
84     </member>
85     <member name="M:System.IO.Compression.ZipFile.ExtractToDirectory(System.String,System.String,System.Text.Encoding,System.Boolean)">
86       <param name="sourceArchiveFileName"></param>
87       <param name="destinationDirectoryName"></param>
88       <param name="entryNameEncoding"></param>
89       <param name="overwriteFiles"></param>
90     </member>
91     <member name="M:System.IO.Compression.ZipFile.Open(System.String,System.IO.Compression.ZipArchiveMode)">
92       <summary>Opens a zip archive at the specified path and in the specified mode.</summary>
93       <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>
94       <param name="mode">One of the enumeration values that specifies the actions which are allowed on the entries in the opened archive.</param>
95       <returns>The opened zip archive.</returns>
96       <exception cref="T:System.ArgumentException"><paramref name="archiveFileName">archiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
97       <exception cref="T:System.ArgumentNullException"><paramref name="archiveFileName">archiveFileName</paramref> is null.</exception>
98       <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName">archiveFileName</paramref>, 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>
99       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="archiveFileName">archiveFileName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
100       <exception cref="T:System.IO.IOException"><paramref name="archiveFileName">archiveFileName</paramref> could not be opened.   -or-  <paramref name="mode">mode</paramref> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create"></see>, but the file specified in <paramref name="archiveFileName">archiveFileName</paramref> already exists.</exception>
101       <exception cref="T:System.UnauthorizedAccessException"><paramref name="archiveFileName">archiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the file specified in <paramref name="archiveFileName">archiveFileName</paramref>.</exception>
102       <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="mode">mode</paramref> specifies an invalid value.</exception>
103       <exception cref="T:System.IO.FileNotFoundException"><paramref name="mode">mode</paramref> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Read"></see>, but the file specified in <paramref name="archiveFileName">archiveFileName</paramref> is not found.</exception>
104       <exception cref="T:System.NotSupportedException"><paramref name="archiveFileName">archiveFileName</paramref> contains an invalid format.</exception>
105       <exception cref="T:System.IO.InvalidDataException"><paramref name="archiveFileName">archiveFileName</paramref> could not be interpreted as a zip archive.   -or-  <paramref name="mode">mode</paramref> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update"></see>, but an entry is missing or corrupt and cannot be read.   -or-  <paramref name="mode">mode</paramref> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update"></see>, but an entry is too large to fit into memory.</exception>
106     </member>
107     <member name="M:System.IO.Compression.ZipFile.Open(System.String,System.IO.Compression.ZipArchiveMode,System.Text.Encoding)">
108       <summary>Opens a zip archive at the specified path, in the specified mode, and by using the specified character encoding for entry names.</summary>
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 that are allowed on the entries in the opened archive.</param>
111       <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>
112       <returns>The opened zip archive.</returns>
113       <exception cref="T:System.ArgumentException"><paramref name="archiveFileName">archiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.   -or-  <paramref name="entryNameEncoding">entryNameEncoding</paramref> is set to a Unicode encoding other than UTF-8.</exception>
114       <exception cref="T:System.ArgumentNullException"><paramref name="archiveFileName">archiveFileName</paramref> is null.</exception>
115       <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName">archiveFileName</paramref>, 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"><paramref name="archiveFileName">archiveFileName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
117       <exception cref="T:System.IO.IOException"><paramref name="archiveFileName">archiveFileName</paramref> could not be opened.   -or-  <paramref name="mode">mode</paramref> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create"></see>, but the file specified in <paramref name="archiveFileName">archiveFileName</paramref> already exists.</exception>
118       <exception cref="T:System.UnauthorizedAccessException"><paramref name="archiveFileName">archiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the file specified in <paramref name="archiveFileName">archiveFileName</paramref>.</exception>
119       <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="mode">mode</paramref> specifies an invalid value.</exception>
120       <exception cref="T:System.IO.FileNotFoundException"><paramref name="mode">mode</paramref> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Read"></see>, but the file specified in <paramref name="archiveFileName">archiveFileName</paramref> is not found.</exception>
121       <exception cref="T:System.NotSupportedException"><paramref name="archiveFileName">archiveFileName</paramref> contains an invalid format.</exception>
122       <exception cref="T:System.IO.InvalidDataException"><paramref name="archiveFileName">archiveFileName</paramref> could not be interpreted as a zip archive.   -or-  <paramref name="mode">mode</paramref> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update"></see>, but an entry is missing or corrupt and cannot be read.   -or-  <paramref name="mode">mode</paramref> is <see cref="F:System.IO.Compression.ZipArchiveMode.Update"></see>, but an entry is too large to fit into memory.</exception>
123     </member>
124     <member name="M:System.IO.Compression.ZipFile.OpenRead(System.String)">
125       <summary>Opens a zip archive for reading at the specified path.</summary>
126       <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>
127       <returns>The opened zip archive.</returns>
128       <exception cref="T:System.ArgumentException"><paramref name="archiveFileName">archiveFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
129       <exception cref="T:System.ArgumentNullException"><paramref name="archiveFileName">archiveFileName</paramref> is null.</exception>
130       <exception cref="T:System.IO.PathTooLongException">In <paramref name="archiveFileName">archiveFileName</paramref>, 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>
131       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="archiveFileName">archiveFileName</paramref> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
132       <exception cref="T:System.IO.IOException"><paramref name="archiveFileName">archiveFileName</paramref> could not be opened.</exception>
133       <exception cref="T:System.UnauthorizedAccessException"><paramref name="archiveFileName">archiveFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the file specified in <paramref name="archiveFileName">archiveFileName</paramref>.</exception>
134       <exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="archiveFileName">archiveFileName</paramref> is not found.</exception>
135       <exception cref="T:System.NotSupportedException"><paramref name="archiveFileName">archiveFileName</paramref> contains an invalid format.</exception>
136       <exception cref="T:System.IO.InvalidDataException"><paramref name="archiveFileName">archiveFileName</paramref> could not be interpreted as a zip archive.</exception>
137     </member>
138     <member name="T:System.IO.Compression.ZipFileExtensions">
139       <summary>Provides extension methods for the <see cref="T:System.IO.Compression.ZipArchive"></see> and <see cref="T:System.IO.Compression.ZipArchiveEntry"></see> classes.</summary>
140     </member>
141     <member name="M:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile(System.IO.Compression.ZipArchive,System.String,System.String)">
142       <summary>Archives a file by compressing it and adding it to the zip archive.</summary>
143       <param name="destination">The zip archive to add the file to.</param>
144       <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>
145       <param name="entryName">The name of the entry to create in the zip archive.</param>
146       <returns>A wrapper for the new entry in the zip archive.</returns>
147       <exception cref="T:System.ArgumentException"><paramref name="sourceFileName">sourceFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.   -or-  <paramref name="entryName">entryName</paramref> is <see cref="F:System.String.Empty"></see>.</exception>
148       <exception cref="T:System.ArgumentNullException"><paramref name="sourceFileName">sourceFileName</paramref> or <paramref name="entryName">entryName</paramref> is null.</exception>
149       <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceFileName">sourceFileName</paramref>, 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>
150       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="sourceFileName">sourceFileName</paramref> is invalid (for example, it is on an unmapped drive).</exception>
151       <exception cref="T:System.IO.IOException">The file specified by <paramref name="sourceFileName">sourceFileName</paramref> cannot be opened.</exception>
152       <exception cref="T:System.UnauthorizedAccessException"><paramref name="sourceFileName">sourceFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the file specified by <paramref name="sourceFileName">sourceFileName</paramref>.</exception>
153       <exception cref="T:System.IO.FileNotFoundException">The file specified by <paramref name="sourceFileName">sourceFileName</paramref> is not found.</exception>
154       <exception cref="T:System.NotSupportedException">The <paramref name="sourceFileName">sourceFileName</paramref> parameter is in an invalid format.   -or-   The zip archive does not support writing.</exception>
155       <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
156     </member>
157     <member name="M:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile(System.IO.Compression.ZipArchive,System.String,System.String,System.IO.Compression.CompressionLevel)">
158       <summary>Archives a file by compressing it using the specified compression level and adding it to the zip archive.</summary>
159       <param name="destination">The zip archive to add the file to.</param>
160       <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>
161       <param name="entryName">The name of the entry to create in the zip archive.</param>
162       <param name="compressionLevel">One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.</param>
163       <returns>A wrapper for the new entry in the zip archive.</returns>
164       <exception cref="T:System.ArgumentException"><paramref name="sourceFileName">sourceFileName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.   -or-  <paramref name="entryName">entryName</paramref> is <see cref="F:System.String.Empty"></see>.</exception>
165       <exception cref="T:System.ArgumentNullException"><paramref name="sourceFileName">sourceFileName</paramref> or <paramref name="entryName">entryName</paramref> is null.</exception>
166       <exception cref="T:System.IO.DirectoryNotFoundException"><paramref name="sourceFileName">sourceFileName</paramref> is invalid (for example, it is on an unmapped drive).</exception>
167       <exception cref="T:System.IO.PathTooLongException">In <paramref name="sourceFileName">sourceFileName</paramref>, 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>
168       <exception cref="T:System.IO.IOException">The file specified by <paramref name="sourceFileName">sourceFileName</paramref> cannot be opened.</exception>
169       <exception cref="T:System.UnauthorizedAccessException"><paramref name="sourceFileName">sourceFileName</paramref> specifies a directory.   -or-   The caller does not have the required permission to access the file specified by <paramref name="sourceFileName">sourceFileName</paramref>.</exception>
170       <exception cref="T:System.IO.FileNotFoundException">The file specified by <paramref name="sourceFileName">sourceFileName</paramref> is not found.</exception>
171       <exception cref="T:System.NotSupportedException">The <paramref name="sourceFileName">sourceFileName</paramref> parameter is in an invalid format.   -or-   The zip archive does not support writing.</exception>
172       <exception cref="T:System.ObjectDisposedException">The zip archive has been disposed.</exception>
173     </member>
174     <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToDirectory(System.IO.Compression.ZipArchive,System.String)">
175       <summary>Extracts all the files in the zip archive to a directory on the file system.</summary>
176       <param name="source">The zip archive to extract files from.</param>
177       <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>
178       <exception cref="T:System.ArgumentException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> is <see cref="F:System.String.Empty"></see>, contains only white space, or contains at least one invalid character.</exception>
179       <exception cref="T:System.ArgumentNullException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> is null.</exception>
180       <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>
181       <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
182       <exception cref="T:System.IO.IOException">The directory specified by <paramref name="destinationDirectoryName">destinationDirectoryName</paramref> already exists.   -or-   The name of an entry in the archive is <see cref="F:System.String.Empty"></see>, 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">destinationDirectoryName</paramref>. (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>
183       <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to write to the destination directory.</exception>
184       <exception cref="T:System.NotSupportedException"><paramref name="destinationDirectoryName">destinationDirectoryName</paramref> contains an invalid format.</exception>
185       <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>
186     </member>
187     <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToDirectory(System.IO.Compression.ZipArchive,System.String,System.Boolean)">
188       <param name="source"></param>
189       <param name="destinationDirectoryName"></param>
190       <param name="overwriteFiles"></param>
191     </member>
192     <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToFile(System.IO.Compression.ZipArchiveEntry,System.String)">
193       <summary>Extracts an entry in the zip archive to a file.</summary>
194       <param name="source">The zip archive entry to extract a file from.</param>
195       <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>
196       <exception cref="T:System.ArgumentException"><paramref name="destinationFileName">destinationFileName</paramref> 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"></see>.   -or-  <paramref name="destinationFileName">destinationFileName</paramref> specifies a directory.</exception>
197       <exception cref="T:System.ArgumentNullException"><paramref name="destinationFileName">destinationFileName</paramref> is null.</exception>
198       <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>
199       <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
200       <exception cref="T:System.IO.IOException"><paramref name="destinationFileName">destinationFileName</paramref> 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>
201       <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to create the new file.</exception>
202       <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>
203       <exception cref="T:System.ObjectDisposedException">The zip archive that this entry belongs to has been disposed.</exception>
204       <exception cref="T:System.NotSupportedException"><paramref name="destinationFileName">destinationFileName</paramref> is in an invalid format.   -or-   The zip archive for this entry was opened in <see cref="F:System.IO.Compression.ZipArchiveMode.Create"></see> mode, which does not permit the retrieval of entries.</exception>
205     </member>
206     <member name="M:System.IO.Compression.ZipFileExtensions.ExtractToFile(System.IO.Compression.ZipArchiveEntry,System.String,System.Boolean)">
207       <summary>Extracts an entry in the zip archive to a file, and optionally overwrites an existing file that has the same name.</summary>
208       <param name="source">The zip archive entry to extract a file from.</param>
209       <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>
210       <param name="overwrite">true to overwrite an existing file that has the same name as the destination file; otherwise, false.</param>
211       <exception cref="T:System.ArgumentException"><paramref name="destinationFileName">destinationFileName</paramref> 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"></see>.   -or-  <paramref name="destinationFileName">destinationFileName</paramref> specifies a directory.</exception>
212       <exception cref="T:System.ArgumentNullException"><paramref name="destinationFileName">destinationFileName</paramref> is null.</exception>
213       <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>
214       <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
215       <exception cref="T:System.IO.IOException"><paramref name="destinationFileName">destinationFileName</paramref> already exists and <paramref name="overwrite">overwrite</paramref> 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>
216       <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to create the new file.</exception>
217       <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>
218       <exception cref="T:System.ObjectDisposedException">The zip archive that this entry belongs to has been disposed.</exception>
219       <exception cref="T:System.NotSupportedException"><paramref name="destinationFileName">destinationFileName</paramref> is in an invalid format.   -or-   The zip archive for this entry was opened in <see cref="F:System.IO.Compression.ZipArchiveMode.Create"></see> mode, which does not permit the retrieval of entries.</exception>
220     </member>
221   </members>
222 </doc></span>