ZipArchive.ExtractToDirectory 方法 (String, String)
擷取所有位於指定的封存到檔案系統上的目錄。 指定的目錄不能存在。 這個方法會建立所有子目錄和指定的目錄。 如果發生錯誤,在擷取時封存,封存保持部分擷取。 每個項目要擷取這類解壓縮檔案具有相同相對路徑做為輸入必須封存的 destinationDirectoryName。 路徑可以指定相對或絕對的路徑資訊。 相對路徑資訊會被解譯為與目前的工作目錄相對。 如果要封存的檔案有無效的上次修改時間, zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。
命名空間: Microsoft.TeamFoundation.Server.Core
組件: Microsoft.TeamFoundation.Server.Core (在 Microsoft.TeamFoundation.Server.Core.dll 中)
語法
'宣告
Public Shared Sub ExtractToDirectory ( _
sourceArchiveFileName As String, _
destinationDirectoryName As String _
)
public static void ExtractToDirectory(
string sourceArchiveFileName,
string destinationDirectoryName
)
參數
- sourceArchiveFileName
類型:System.String
封存的路徑 (要擷取的檔案系統。
- destinationDirectoryName
類型:System.String
目錄的路徑在檔案系統。指定的目錄不能存在,不過,目錄會包含必須存在。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentException | sourceArchive 或 destinationDirectoryName 長度為零的字串、只包含空白字元,或包含一個或多個無效的字元 (如所定義 InvalidPathChars。 |
ArgumentNullException | sourceArchive 或 destinationDirectoryName 是空的。 |
PathTooLongException | sourceArchive 或 destinationDirectoryName 指定路徑,檔案名稱,或兩者都超過系統定義的最大長度。 例如:在 Windows 平台上,路徑必須小於 248 字元,而檔案名稱必須小於 260 字元。 |
DirectoryNotFoundException | sourceArchive 或 destinationDirectoryName 指定的路徑無效, (例如,位於未對應的磁碟上)。 |
IOException | destinationDirectoryName 已存在指定的目錄。-或- I/O 錯誤。-或-封存項目名稱是長度為零的、只包含泛空白字元,或包含一個或多個無效的字元 (如所定義 InvalidPathChars。-或-解壓縮封存項目會導致像是在目標目錄外的檔案 (目的,因為父目錄存取子)。-或-封存項目與從相同的已擷取的輸入封存的名稱。 |
UnauthorizedAccessException | 呼叫端沒有必要的使用權限。 |
NotSupportedException | sourceArchive 或 destinationDirectoryName 的格式無效。 |
FileNotFoundException | sourceArchive 找不到。 |
InvalidDataException | sourceArchive 指定的封存:不是有效 ZipArchive -或封存中找不到或已損毀。-或-封存壓縮使用不支援的壓縮方法。 |
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。