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，如果檔案不存在。如果指定 create，檔案以開啟 System.IO.FileMode.CreateNew 並擲回 System.IO.IOException，如果檔案已經存在。如果更新指定，檔案以開啟 System.IO.FileMode.OpenOrCreate。如果檔案存在且是 ZIP 檔案，該項目會變成可以存取，而且可能會被修改，因此，新項目會建立。如果檔案存在且不是 ZIP 檔案， ZipArchiveException 將會擲回。如果檔案存在而且是空的或不存在，新的 ZIP 檔案的建立。表示建立新的 zip 檔時，請注意建立 ZIP 檔案在 ZipArchiveMode.Create 模式的，會更有效率。

例外狀況	條件
ArgumentException	路徑是長度為零的字串、只包含空白字元，或包含一個或多個無效的字元 (如所定義 InvalidPathChars。
ArgumentNullException	path 是 null。
PathTooLongException	指定的路徑、檔案名稱或兩者都超過系統定義的最大長度。例如：在 Windows 平台上，路徑必須小於 248 字元，而檔案名稱必須小於 260 字元。
DirectoryNotFoundException	指定的路徑無效 (例如，位於未對應的磁碟上)。
IOException	開啟檔案時發生 I/O 錯誤。
UnauthorizedAccessException	路徑指定了目錄。-或-呼叫端沒有必要的使用權限。
ArgumentOutOfRangeException	模式指定了無效的值。
FileNotFoundException	在路徑指定的檔案找不到。
NotSupportedException	路徑的格式無效。
InvalidDataException	指定的檔案不能被解譯為 zip 檔。-或-方式是更新，並從封存中遺失，或已損毀且無法讀取。-或-方式來更新，然後輸入太大而無法放入記憶體。