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