TarEntry.ExtractToFile(String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает текущий файл или каталог в файловую систему. Символические и жесткие ссылки не извлекаются.
public:
void ExtractToFile(System::String ^ destinationFileName, bool overwrite);public void ExtractToFile (string destinationFileName, bool overwrite);member this.ExtractToFile : string * bool -> unitPublic Sub ExtractToFile (destinationFileName As String, overwrite As Boolean)Параметры
- destinationFileName
- String
Путь к целевому файлу.
- overwrite
- Boolean
true Значение , если этот метод должен перезаписать любой существующий объект файловой системы, расположенный destinationFileName в пути; значение , false чтобы предотвратить перезапись.
Исключения
destinationFileName имеет значение null.
Параметр destinationFileName пуст.
Родительский destinationFileName каталог не существует.
-или-
overwrite имеет значение false , а файл уже существует в destinationFileName.
-или-
Существует каталог с тем же именем, что и destinationFileName.
-или-
Возникла проблема ввода-вывода.
Предпринята попытка извлечь символьную ссылку, жесткую ссылку или неподдерживаемый тип записи.
Операция не разрешена из-за недостатка разрешений.
Комментарии
Файлы типа BlockDevice, CharacterDeviceили Fifo можно извлечь только на платформах Unix.
Для извлечения BlockDevice или CharacterDevice на диск требуется повышение прав.
Символические ссылки можно воссоздать с помощью CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)или CreateAsSymbolicLink(String).
Жесткие ссылки можно извлечь только при использовании ExtractToDirectory(Stream, String, Boolean) или ExtractToDirectory(String, String, Boolean).
