TarFile.ExtractToDirectory Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| ExtractToDirectory(Stream, String, Boolean) |
Extrae el contenido de una secuencia que representa un archivo tar en el directorio especificado. |
| ExtractToDirectory(Stream, String, TarExtractOptions) | |
| ExtractToDirectory(String, String, Boolean) |
Extrae el contenido de un archivo tar en el directorio especificado. |
| ExtractToDirectory(String, String, TarExtractOptions) |
ExtractToDirectory(Stream, String, Boolean)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Extrae el contenido de una secuencia que representa un archivo tar en el directorio especificado.
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles);static member ExtractToDirectory : System.IO.Stream * string * bool -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)Parámetros
- source
- Stream
Secuencia que contiene el archivo tar.
- destinationDirectoryName
- String
Ruta de acceso del directorio de destino donde se deben extraer las entradas del sistema de archivos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- overwriteFiles
- Boolean
true para sobrescribir archivos y directorios en destinationDirectoryName; false para evitar sobrescribir y producir si se encuentran archivos o directorios con nombres existentes.
Excepciones
source o destinationDirectoryName es null.
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
Los permisos no son suficientes.
La extracción de una de las entradas tar habría dado lugar a un archivo fuera del directorio de destino especificado.
O bien
destinationDirectoryName está vacío.
O bien
source no admite la lectura.
.NET solo 11 y versiones posteriores: la suma de comprobación de una entrada no es válida.
Se produjo una excepción de E/S.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
Se aplica a
ExtractToDirectory(Stream, String, TarExtractOptions)
- Source:
- TarFile.cs
public:
static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);static member ExtractToDirectory : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)Parámetros
- source
- Stream
- destinationDirectoryName
- String
Ruta de acceso al directorio en el que se van a colocar los archivos extraídos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- options
- TarExtractOptions
Excepciones
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
La ruta de acceso puede ser relativa o absoluta. Una ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Si se produce un error durante la extracción, el archivo permanece parcialmente extraído.
Establézcalo OverwriteFiles en true para sobrescribir los archivos existentes. El valor predeterminado es false. Use HardLinkMode para controlar cómo se extraen las entradas de vínculo físico.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
La source secuencia se deja abierta después de la extracción.
Se aplica a
ExtractToDirectory(String, String, Boolean)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Extrae el contenido de un archivo tar en el directorio especificado.
public:
static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, bool overwriteFiles);static member ExtractToDirectory : string * string * bool -> unitPublic Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)Parámetros
- sourceFileName
- String
Ruta de acceso del archivo tar que se va a extraer.
- destinationDirectoryName
- String
Ruta de acceso del directorio de destino donde se deben extraer las entradas del sistema de archivos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- overwriteFiles
- Boolean
true para sobrescribir archivos y directorios en destinationDirectoryName; false para evitar sobrescribir y producir si se encuentran archivos o directorios con nombres existentes.
Excepciones
sourceFileName o destinationDirectoryName es null.
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
No se encuentra la ruta de acceso del sourceFileName archivo.
Los permisos no son suficientes.
La extracción de una de las entradas tar habría dado lugar a un archivo fuera del directorio de destino especificado.
O bien
sourceFileName o destinationDirectoryName está vacío.
.NET solo 11 y versiones posteriores: la suma de comprobación de una entrada no es válida.
Se produjo una excepción de E/S.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
Se aplica a
ExtractToDirectory(String, String, TarExtractOptions)
- Source:
- TarFile.cs
public:
static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);static member ExtractToDirectory : string * string * System.Formats.Tar.TarExtractOptions -> unitPublic Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)Parámetros
- sourceFileName
- String
- destinationDirectoryName
- String
Ruta de acceso al directorio en el que se van a colocar los archivos extraídos. En .NET 11 y versiones anteriores, el directorio ya debe existir. En .NET 12 y versiones posteriores, los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
- options
- TarExtractOptions
Excepciones
.NET 11 y versiones anteriores: el destinationDirectoryName directorio no existe.
Comentarios
Warning
Este método no se debe usar para extraer archivos que no son de confianza. No aplica ningún límite de tamaño, límites de recuento de entradas u otras directivas necesarias para la extracción segura de archivos que no son de confianza. Para obtener más información sobre cómo extraer archivos de forma segura de orígenes que no son de confianza, consulte Procedimientos recomendados para usar archivos zip y tar.
En .NET 11 y versiones anteriores, el directorio especificado por destinationDirectoryName ya debe existir. Si no existe, este método produce un DirectoryNotFoundException, incluso si el archivo está vacío.
En .NET 12 y versiones posteriores, el directorio de destino ya puede existir. Los directorios primarios y de destino que faltan se crean según sea necesario cuando se extraen las entradas. Un archivo vacío no crea directorios.
La ruta de acceso puede ser relativa o absoluta. Una ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual.
Si se produce un error durante la extracción, el archivo permanece parcialmente extraído.
Establézcalo OverwriteFiles en true para sobrescribir los archivos existentes. El valor predeterminado es false. Use HardLinkMode para controlar cómo se extraen las entradas de vínculo físico.
Si un vínculo simbólico o una unión en el archivo tar da como resultado que un archivo se extraiga fuera del especificado destinationDirectoryName, se produce una IOException excepción para asegurarse de que la extracción permanece dentro del mismo directorio.
Si destinationDirectoryName o cualquiera de sus directorios primarios es una unión preexistente o un vínculo simbólico, se sigue el vínculo y la extracción escribe en la carpeta de destino final.
Los archivos de tipo BlockDevice, CharacterDeviceo Fifo solo se pueden extraer en plataformas Unix.
La elevación es necesaria para extraer un BlockDevice disco o CharacterDevice .
