TarFile.ExtractToDirectory 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| ExtractToDirectory(Stream, String, Boolean) |
將代表 tar 壓縮檔的串流內容解壓到指定的目錄中。 |
| ExtractToDirectory(Stream, String, TarExtractOptions) | |
| ExtractToDirectory(String, String, Boolean) |
將 tar 檔案的內容解壓到指定的目錄中。 |
| ExtractToDirectory(String, String, TarExtractOptions) |
ExtractToDirectory(Stream, String, Boolean)
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- 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
包含瀝青檔案的溪流。
- destinationDirectoryName
- String
目的地目錄的路徑,檔案系統條目應該被解壓。 在 .NET 11 及更早版本中,該目錄必須已經存在。 在 .NET 12 及更新版本中,當提取條目時,會根據需要建立缺少的目的地和父目錄。 空的壓縮檔不會建立任何目錄。
- overwriteFiles
- Boolean
true 覆寫檔案 destinationDirectoryName與目錄; false 以避免覆寫,若發現已有檔案或目錄名稱則丟棄。
例外狀況
source 或 destinationDirectoryName 為 null。
.NET 11 及更早版本:destinationDirectoryName目錄不存在。
解壓其中一個 tar 條目會導致檔案出現在指定目的目錄之外。
-或-
destinationDirectoryName 空無一人。
-或-
source 不支援閱讀。
僅限 .NET 11 及更新版本:條目的校驗和無效。
發生了 I/O 例外。
備註
Warning
此方法不得用於解壓不受信任的檔案。 它不強制執行任何大小限制、條目數量限制或其他安全解壓不可信檔案所需的政策。 欲了解更多如何安全解壓來自不可信來源的壓縮檔,請參閱 使用壓縮檔與 tar 壓縮檔的最佳實務。
在 .NET 11 及更早版本中,指定的destinationDirectoryName目錄必須已經存在。 如果不存在,這個方法會拋出一個 DirectoryNotFoundException,即使壓縮檔是空的。
在 .NET 12 及更新版本中,目的目錄已經可以存在。 缺少的目的地目錄和父目錄會在提取條目時依需要建立。 空的壓縮檔不會建立任何目錄。
如果 tar 壓縮檔中的符號連結或交接導致檔案被解壓在指定 destinationDirectoryName目錄之外,則會拋出 an IOException 以確保解壓仍在同一目錄中。
如果 destinationDirectoryName 其父目錄中的任何一個是既有的連接或符號連結,則會沿著連結追蹤,並將擷取寫入最終目標資料夾。
類型為 BlockDevice、 CharacterDevice或 Fifo 的檔案只能在 Unix 平台中解壓。
提取 a BlockDevice 或 CharacterDevice 磁碟需要抬高。
適用於
ExtractToDirectory(Stream, String, TarExtractOptions)
- 來源:
- TarFile.cs
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)
參數
- source
- Stream
- destinationDirectoryName
- String
指向存放擷取檔案目錄的路徑。 在 .NET 11 及更早版本中,該目錄必須已經存在。 在 .NET 12 及更新版本中,當提取條目時,會根據需要建立缺少的目的地和父目錄。 空的壓縮檔不會建立任何目錄。
- options
- TarExtractOptions
例外狀況
.NET 11 及更早版本:destinationDirectoryName目錄不存在。
備註
Warning
此方法不得用於解壓不受信任的檔案。 它不強制執行任何大小限制、條目數量限制或其他安全解壓不可信檔案所需的政策。 欲了解更多如何安全解壓來自不可信來源的壓縮檔,請參閱 使用壓縮檔與 tar 壓縮檔的最佳實務。
在 .NET 11 及更早版本中,指定的destinationDirectoryName目錄必須已經存在。 如果不存在,這個方法會拋出一個 DirectoryNotFoundException,即使壓縮檔是空的。
在 .NET 12 及更新版本中,目的目錄已經可以存在。 缺少的目的地目錄和父目錄會在提取條目時依需要建立。 空的壓縮檔不會建立任何目錄。
路徑可為相對路徑或絕對路徑。 相對路徑會被解讀為相對於目前工作目錄的相對於。
若解壓過程中發生錯誤,該壓縮檔仍維持部分解壓狀態。
設定 OverwriteFiles 為 以 true 覆蓋現有檔案。 預設值為 false。 用 HardLinkMode 來控制如何擷取硬連結條目。
如果 tar 壓縮檔中的符號連結或交接導致檔案被解壓在指定 destinationDirectoryName目錄之外,則會拋出 an IOException 以確保解壓仍在同一目錄中。
如果 destinationDirectoryName 其父目錄中的任何一個是既有的連接或符號連結,則會沿著連結追蹤,並將擷取寫入最終目標資料夾。
類型為 BlockDevice、 CharacterDevice或 Fifo 的檔案只能在 Unix 平台中解壓。
提取 a BlockDevice 或 CharacterDevice 磁碟需要抬高。
萃取後溪 source 流會保持開放狀態。
適用於
ExtractToDirectory(String, String, Boolean)
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- TarFile.cs
- 來源:
- 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
目的地目錄的路徑,檔案系統條目應該被解壓。 在 .NET 11 及更早版本中,該目錄必須已經存在。 在 .NET 12 及更新版本中,當提取條目時,會根據需要建立缺少的目的地和父目錄。 空的壓縮檔不會建立任何目錄。
- overwriteFiles
- Boolean
true 覆寫檔案 destinationDirectoryName與目錄; false 以避免覆寫,若發現已有檔案或目錄名稱則丟棄。
例外狀況
sourceFileName 或 destinationDirectoryName 為 null。
.NET 11 及更早版本:destinationDirectoryName目錄不存在。
找不到檔案路徑。sourceFileName
解壓其中一個 tar 條目會導致檔案出現在指定目的目錄之外。
-或-
sourceFileName 或者 destinationDirectoryName 是空的。
僅限 .NET 11 及更新版本:條目的校驗和無效。
發生了 I/O 例外。
備註
Warning
此方法不得用於解壓不受信任的檔案。 它不強制執行任何大小限制、條目數量限制或其他安全解壓不可信檔案所需的政策。 欲了解更多如何安全解壓來自不可信來源的壓縮檔,請參閱 使用壓縮檔與 tar 壓縮檔的最佳實務。
在 .NET 11 及更早版本中,指定的destinationDirectoryName目錄必須已經存在。 如果不存在,這個方法會拋出一個 DirectoryNotFoundException,即使壓縮檔是空的。
在 .NET 12 及更新版本中,目的目錄已經可以存在。 缺少的目的地目錄和父目錄會在提取條目時依需要建立。 空的壓縮檔不會建立任何目錄。
如果 tar 壓縮檔中的符號連結或交接導致檔案被解壓在指定 destinationDirectoryName目錄之外,則會拋出 an IOException 以確保解壓仍在同一目錄中。
如果 destinationDirectoryName 其父目錄中的任何一個是既有的連接或符號連結,則會沿著連結追蹤,並將擷取寫入最終目標資料夾。
類型為 BlockDevice、 CharacterDevice或 Fifo 的檔案只能在 Unix 平台中解壓。
提取 a BlockDevice 或 CharacterDevice 磁碟需要抬高。
適用於
ExtractToDirectory(String, String, TarExtractOptions)
- 來源:
- TarFile.cs
public:
static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : string * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)
參數
- sourceFileName
- String
- destinationDirectoryName
- String
指向存放擷取檔案目錄的路徑。 在 .NET 11 及更早版本中,該目錄必須已經存在。 在 .NET 12 及更新版本中,當提取條目時,會根據需要建立缺少的目的地和父目錄。 空的壓縮檔不會建立任何目錄。
- options
- TarExtractOptions
例外狀況
.NET 11 及更早版本:destinationDirectoryName目錄不存在。
備註
Warning
此方法不得用於解壓不受信任的檔案。 它不強制執行任何大小限制、條目數量限制或其他安全解壓不可信檔案所需的政策。 欲了解更多如何安全解壓來自不可信來源的壓縮檔,請參閱 使用壓縮檔與 tar 壓縮檔的最佳實務。
在 .NET 11 及更早版本中,指定的destinationDirectoryName目錄必須已經存在。 如果不存在,這個方法會拋出一個 DirectoryNotFoundException,即使壓縮檔是空的。
在 .NET 12 及更新版本中,目的目錄已經可以存在。 缺少的目的地目錄和父目錄會在提取條目時依需要建立。 空的壓縮檔不會建立任何目錄。
路徑可為相對路徑或絕對路徑。 相對路徑會被解讀為相對於目前工作目錄的相對於。
若解壓過程中發生錯誤,該壓縮檔仍維持部分解壓狀態。
設定 OverwriteFiles 為 以 true 覆蓋現有檔案。 預設值為 false。 用 HardLinkMode 來控制如何擷取硬連結條目。
如果 tar 壓縮檔中的符號連結或交接導致檔案被解壓在指定 destinationDirectoryName目錄之外,則會拋出 an IOException 以確保解壓仍在同一目錄中。
如果 destinationDirectoryName 其父目錄中的任何一個是既有的連接或符號連結,則會沿著連結追蹤,並將擷取寫入最終目標資料夾。
類型為 BlockDevice、 CharacterDevice或 Fifo 的檔案只能在 Unix 平台中解壓。
提取 a BlockDevice 或 CharacterDevice 磁碟需要抬高。