ZipFileExtensions.ExtractToDirectoryAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將壓縮檔中的所有檔案解壓到檔案系統上的目錄。 指定的目錄可能已經存在。
多載
| 名稱 | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
非同步地將壓縮檔中的所有檔案解壓到檔案系統上的目錄。 指定的目錄可能已經存在。 |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
將壓縮檔中的所有檔案解壓到檔案系統上的目錄。 指定的目錄可能已經存在。 |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
非同步地將壓縮檔中的所有檔案解壓到檔案系統上的目錄。 指定的目錄可能已經存在。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task參數
- source
- ZipArchive
zip 壓縮檔用來解壓檔案。
- destinationDirectoryName
- String
檔案系統中目錄的路徑。
- cancellationToken
- CancellationToken
取消令牌用來監控取消申請。
傳回
例外狀況
destinationDirectoryName 是零長度字串，僅包含空白，或包含一個或多個無效字元，依 InvalidPathChars 定義。
destinationDirectoryName 是 null。
指定的路徑、檔名或兩者都超過系統定義的最大長度。 例如，在基於 Windows 的平台上，路徑必須少於 248 個字元，檔案名稱必須少於 260 個字元。
指定的路徑無效（例如，它位於未映射的硬碟上）。
歸檔項目名稱為零長度，僅包含空白，或包含一個或多個無效字元，依 InvalidPathChars 定義。
-或-
解壓壓縮檔條目會導致目標檔案位於外部 destinationDirectoryName （例如，若條目名稱包含父目錄存取者）。
-或-
一個檔案庫的條目名稱與已從同一檔案庫提取的條目相同。
來電者沒有所需的權限。
destinationDirectoryName 格式無效。
非同步操作被取消。
備註
指定的目錄不存在。 路徑可指定相對或絕對路徑資訊。 相對路徑資訊會被解讀為相對於目前工作目錄的相對於。
此方法會建立所有子目錄及指定目錄（如有需要）。
若解壓時發生錯誤，該壓縮檔仍保持部分解壓狀態。
每個項目的解壓路徑與該條目到檔案根目錄的路徑 destinationDirectoryName 相同。 若要歸檔的檔案最後修改時間無效，則會使用第一個可以 Zip 時間戳格式表示的日期時間（1980 年 1 月 1 日午夜）。
適用於
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
將壓縮檔中的所有檔案解壓到檔案系統上的目錄。 指定的目錄可能已經存在。
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task參數
- source
- ZipArchive
zip 壓縮檔用來解壓檔案。
- destinationDirectoryName
- String
檔案系統中目錄的路徑。
- overwriteFiles
- Boolean
true 覆寫檔案; false 否則，
- cancellationToken
- CancellationToken
取消令牌用來監控取消申請。
傳回
例外狀況
destinationDirectoryName 是零長度字串，僅包含空白，或包含一個或多個無效字元，依 InvalidPathChars 定義。
此方法會建立所有子目錄及指定目錄（如有需要）。
若解壓時發生錯誤，該壓縮檔將保持部分解壓狀態。
每個項目的解壓路徑與該條目到檔案根目錄的路徑 destinationDirectoryName 相同。 若要歸檔的檔案最後修改時間無效，則會使用第一個可以 Zip 時間戳格式表示的日期時間（1980 年 1 月 1 日午夜）。
destinationDirectoryName 是 null。
指定的路徑無效（例如，它位於未映射的硬碟上）。
歸檔項目名稱為零長度，僅包含空白，或包含一個或多個無效字元，依 InvalidPathChars 定義。
-或-
解壓壓縮檔條目會導致目標檔案位於外部 destinationDirectoryName （例如，若條目名稱包含父目錄存取者）。
-或-
一個檔案庫的條目名稱與已從同一檔案庫提取的條目相同。
來電者沒有所需的權限。
destinationDirectoryName 格式無效。
備註
指定的目錄不存在。 路徑可指定相對或絕對路徑資訊。 相對路徑資訊會被解讀為相對於目前工作目錄的相對於。
適用於
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As Task參數
- source
- ZipArchive
- destinationDirectoryName
- String
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
