TarEntry.ExtractToFile(String, Boolean) 方法

定义

命名空间:

System.Formats.Tar

程序集:

System.Formats.Tar.dll

Source:

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 平台中提取。

需要提升才能将 或 CharacterDevice 提取BlockDevice到磁盘。

可以使用 、 CreateSymbolicLink(String, String)或 CreateAsSymbolicLink(String)重新创建CreateSymbolicLink(String, String)符号链接。

仅当使用 ExtractToDirectory(Stream, String, Boolean) 或 ExtractToDirectory(String, String, Boolean)时，才能提取硬链接。