TarEntry.ExtractToFile(String, Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将当前文件或目录提取到文件系统。 不提取符号链接和硬链接。
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
以防止覆盖。
例外
destinationFileName
为 null
。
destinationFileName
为空。
的 destinationFileName
父目录不存在。
-或-
overwrite
为 false
,并且 中 destinationFileName
已存在文件。
-或-
存在与 同名 destinationFileName
的目录。
-或-
发生了 I/O 问题。
尝试提取符号链接、硬链接或不受支持的条目类型。
由于权限不足,不允许操作。
注解
类型为 BlockDevice、 CharacterDevice或 Fifo 的文件只能在 Unix 平台中提取。
需要提升才能将 或 CharacterDevice 提取BlockDevice到磁盘。
可以使用 、 CreateSymbolicLink(String, String)或 CreateAsSymbolicLink(String)重新创建CreateSymbolicLink(String, String)符号链接。
仅当使用 ExtractToDirectory(Stream, String, Boolean) 或 ExtractToDirectory(String, String, Boolean)时,才能提取硬链接。