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.

-или-

Возникла проблема ввода-вывода.

InvalidOperationException

Предпринята попытка извлечь символьную ссылку, жесткую ссылку или неподдерживаемый тип записи.

UnauthorizedAccessException

Операция не разрешена из-за недостатка разрешений.

Комментарии

Файлы типа BlockDevice, CharacterDeviceили Fifo можно извлечь только на платформах Unix.

Для извлечения BlockDevice или CharacterDevice на диск требуется повышение прав.

Символические ссылки можно воссоздать с помощью CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)или CreateAsSymbolicLink(String).

Жесткие ссылки можно извлечь только при использовании ExtractToDirectory(Stream, String, Boolean) или ExtractToDirectory(String, String, Boolean).