ZipArchive 构造函数 (String, ZipArchiveMode)
打开在指定的路径的 ZipArchive 在指定的 ZipArchiveMode 模式。
命名空间: Microsoft.TeamFoundation.Server.Core
程序集: Microsoft.TeamFoundation.Server.Core(在 Microsoft.TeamFoundation.Server.Core.dll 中)
语法
声明
Public Sub New ( _
archiveFileName As String, _
mode As ZipArchiveMode _
)
public ZipArchive(
string archiveFileName,
ZipArchiveMode mode
)
参数
- archiveFileName
类型:System.String
指定路径的字符串在文件系统打开存档。路径允许指定相对路径或绝对路径信息。相对路径信息被解释为相对于当前工作目录。
- mode
类型:Microsoft.TeamFoundation.Server.Core.ZipArchiveMode
ZipArchiveMode 参见枚举的说明。如果读取指定文件,打开与 System.IO.FileMode.Open 并引发 FileNotFoundException,如果文件不存在。如果创建指定,该文件将打开与 System.IO.FileMode.CreateNew 并引发 System.IO.IOException,如果该文件已经存在。如果更新指定文件,打开与 System.IO.FileMode.OpenOrCreate。如果文件存在且是压缩文件,则该项会变得可访问,并可通过修改,因此,新项可以创建。如果文件存在且不是压缩文件,ZipArchiveException 将引发异常。如果文件存在且为空或不存在,一个新的压缩文件中创建。当创建新的压缩文件时,请注意创建压缩文件,用 ZipArchiveMode.Create 模式的效率更高。
异常
异常 | 条件 |
---|---|
ArgumentException | 路径是零长度字符串;仅包含空白或包含一个或多个无效字符所定义的 InvalidPathChars。 |
ArgumentNullException | path 为 null。 |
PathTooLongException | 指定的路径、文件名或者两者都超出了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。 |
DirectoryNotFoundException | 指定的路径无效(例如,它位于未映射的驱动器上)。 |
IOException | 打开文件时发生 I/O 错误。 |
UnauthorizedAccessException | 路径指定的内容。-或调用方没有必需的权限。 |
ArgumentOutOfRangeException | 模式指定了无效的值。 |
FileNotFoundException | 未找到在路径中指定的文件。 |
NotSupportedException | 路径以使布局失效。 |
InvalidDataException | 使用指定的文件不能被解释为压缩文件。-或模式是更新,并项从存档缺少或损坏,无法读取。-或模式是更新,并项太大而无法放入内存。 |
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。