TarFile.ExtractToDirectory 方法

定義

命名空間:

System.Formats.Tar

組件:

System.Formats.Tar.dll

多載

ExtractToDirectory(Stream, String, Boolean)	將代表 tar 封存的數據流內容擷取到指定的目錄中。
ExtractToDirectory(String, String, Boolean)	將 tar 檔案的內容解壓縮到指定的目錄中。

ExtractToDirectory(Stream, String, Boolean)

來源:

TarFile.cs

將代表 tar 封存的數據流內容擷取到指定的目錄中。

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : System.IO.Stream * string * bool -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)

參數

source

Stream

包含 tar 封存的數據流。

destinationDirectoryName

String

應擷取文件系統專案之目的地目錄的路徑。

overwriteFiles

Boolean

true 表示覆寫 中的 destinationDirectoryName檔案和目錄; false 若要避免覆寫，並在找到任何具有現有名稱的檔案或目錄時擲回 。

例外狀況

ArgumentNullException

source 或 destinationDirectoryName 為 null。

DirectoryNotFoundException

destinationDirectoryName找不到目錄路徑。

UnauthorizedAccessException

許可權不足。

ArgumentException

擷取其中一個 tar 專案會導致檔案超出指定的目的地目錄。

-或-

destinationDirectoryName 是空的。

-或-

source 不支援讀取。

IOException

發生 I/O 例外狀況。

備註

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

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

ExtractToDirectory(String, String, Boolean)

來源:

TarFile.cs

將 tar 檔案的內容解壓縮到指定的目錄中。

public:
 static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory (string sourceFileName, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : string * string * bool -> unit

Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

參數

sourceFileName

String

要解壓縮之 tar 檔案的路徑。

destinationDirectoryName

String

應擷取文件系統專案之目的地目錄的路徑。

overwriteFiles

Boolean

true 表示覆寫 中的 destinationDirectoryName檔案和目錄; false 若要避免覆寫，並在找到任何具有現有名稱的檔案或目錄時擲回 。

例外狀況

ArgumentNullException

sourceFileName 或 destinationDirectoryName 為 null。

DirectoryNotFoundException

destinationDirectoryName找不到目錄路徑。

FileNotFoundException

sourceFileName找不到檔案路徑。

UnauthorizedAccessException

許可權不足。

ArgumentException

擷取其中一個 tar 專案會導致檔案超出指定的目的地目錄。

-或-

sourceFileName 或 destinationDirectoryName 是空的。

IOException

發生 I/O 例外狀況。

備註

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

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