TarEntry.ExtractToFile(String, Boolean) 方法

定義

命名空間:

System.Formats.Tar

組件:

System.Formats.Tar.dll

來源:

TarEntry.cs

將目前的檔案或目錄解壓縮至檔案系統。 不會擷取符號連結和硬式連結。

public:
 void ExtractToFile(System::String ^ destinationFileName, bool overwrite);

public void ExtractToFile (string destinationFileName, bool overwrite);

member this.ExtractToFile : string * bool -> unit

Public Sub ExtractToFile (destinationFileName As String, overwrite As Boolean)

參數

destinationFileName

String

目的地檔案的路徑。

overwrite

Boolean

true 如果這個方法應該覆寫路徑中的任何 destinationFileName 現有文件系統物件，則為 ， false 以防止覆寫。

例外狀況

ArgumentNullException

destinationFileName 為 null。

ArgumentException

destinationFileName 是空的。

IOException

的 destinationFileName 父目錄不存在。

-或-

overwrite 為 false ，且檔案已存在於 中 destinationFileName。

-或-

目錄的名稱與 相同 destinationFileName。

-或-

發生 I/O 問題。

InvalidOperationException

嘗試擷取符號連結、硬連結或不支援的項目類型。

UnauthorizedAccessException

作業因為許可權不足而不允許。

備註

類型 BlockDevice為、 CharacterDevice或 Fifo 的檔案只能在 Unix 平臺中擷取。

需要提高許可權才能擷取 BlockDevice 或 CharacterDevice 磁碟。

符號連結可以使用、 CreateSymbolicLink(String, String)或 CreateAsSymbolicLink(String)重新建立CreateSymbolicLink(String, String)。

使用 或 ExtractToDirectory(String, String, Boolean)時ExtractToDirectory(Stream, String, Boolean)，只能擷取硬式連結。