TarEntry.ExtractToFile(String, Boolean) Método

Definición

Espacio de nombres:

System.Formats.Tar

Ensamblado:

System.Formats.Tar.dll

Source:

TarEntry.cs

Extrae el archivo o directorio actual en el sistema de archivos. No se extraen vínculos simbólicos ni vínculos físicos.

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)

Parámetros

destinationFileName

String

Ruta de acceso al archivo de destino.

overwrite

Boolean

true si este método debe sobrescribir cualquier objeto del sistema de archivos existente ubicado en la destinationFileName ruta de acceso; false para evitar la sobrescritura.

Excepciones

ArgumentNullException

destinationFileName es null.

ArgumentException

destinationFileName está vacía.

IOException

El directorio primario de destinationFileName no existe.

O bien

overwrite es false y ya existe un archivo en destinationFileName.

O bien

Existe un directorio con el mismo nombre que destinationFileName.

O bien

Se ha producido un problema de E/S.

InvalidOperationException

Se intentó extraer un vínculo simbólico, un vínculo físico o un tipo de entrada no admitido.

UnauthorizedAccessException

La operación no se permite debido a permisos insuficientes.

Comentarios

Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.

La elevación es necesaria para extraer un BlockDevice o CharacterDevice en el disco.

Los vínculos simbólicos se pueden volver a crear mediante CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)o CreateAsSymbolicLink(String).

Los vínculos físicos solo se pueden extraer cuando se usa ExtractToDirectory(Stream, String, Boolean) o ExtractToDirectory(String, String, Boolean).