TarFile.ExtractToDirectory Méthode

Définition

Espace de noms:: System.Formats.Tar

Assembly:: System.Formats.Tar.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
ExtractToDirectory(Stream, String, Boolean)	Extrait le contenu d’un flux qui représente une archive tar dans le répertoire spécifié.
ExtractToDirectory(Stream, String, TarExtractOptions)
ExtractToDirectory(String, String, Boolean)	Extrait le contenu d’un fichier tar dans le répertoire spécifié.
ExtractToDirectory(String, String, TarExtractOptions)

ExtractToDirectory(Stream, String, Boolean)

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Extrait le contenu d’un flux qui représente une archive tar dans le répertoire spécifié.

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 -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)

Paramètres

source: Stream

Flux contenant l’archive tar.

destinationDirectoryName: String

Chemin d’accès du répertoire de destination où les entrées du système de fichiers doivent être extraites. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.

overwriteFiles: Boolean

true pour remplacer les fichiers et les répertoires dans destinationDirectoryName; false pour éviter le remplacement et lever si des fichiers ou répertoires sont trouvés avec des noms existants.

Exceptions

ArgumentNullException

source ou destinationDirectoryName est null.

DirectoryNotFoundException

.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.

UnauthorizedAccessException

Les autorisations sont insuffisantes.

ArgumentException

L’extraction de l’une des entrées tar aurait entraîné un fichier en dehors du répertoire de destination spécifié.

- ou -

destinationDirectoryName est vide.

- ou -

source ne prend pas en charge la lecture.

InvalidDataException

.NET 11 et versions ultérieures uniquement : la somme de contrôle d'une entrée n'est pas valide.

IOException

Une exception d’E/S s’est produite.

Remarques

Warning

Cette méthode ne doit pas être utilisée pour extraire des archives non approuvées. Elle n’applique aucune limite de taille, limite de nombre d’entrées ou autres stratégies nécessaires à l’extraction sécurisée d’archives non approuvées. Pour plus d’informations sur l’extraction sécurisée d’archives provenant de sources non approuvées, consultez les meilleures pratiques pour l’utilisation des archives zip et tar.

Dans .NET 11 et versions antérieures, le répertoire spécifié par destinationDirectoryName doit déjà exister. S’il n’existe pas, cette méthode lève une DirectoryNotFoundExceptionexception , même si l’archive est vide.

Dans .NET 12 et versions ultérieures, le répertoire de destination peut déjà exister. Les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.

Si un lien symbolique ou une jonction dans l’archive tar entraîne l’extraction d’un fichier en dehors du fichier spécifié destinationDirectoryName, il IOException est levée pour garantir que l’extraction reste dans le même répertoire.

Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.

Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.

L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.

S’applique à

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 -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)

Paramètres

source: Stream

destinationDirectoryName: String

Chemin d’accès au répertoire dans lequel placer les fichiers extraits. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.

options: TarExtractOptions

Exceptions

DirectoryNotFoundException

.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.

Remarques

Warning

Le chemin peut être relatif ou absolu. Un chemin relatif est interprété comme relatif au répertoire de travail actuel.

Si une erreur se produit lors de l’extraction, l’archive reste partiellement extraite.

Définissez cette option OverwriteFiles pour true remplacer les fichiers existants. La valeur par défaut est false. Permet HardLinkMode de contrôler l’extraction des entrées de lien dur.

Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.

Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.

L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.

Le source flux est laissé ouvert après l’extraction.

S’applique à

ExtractToDirectory(String, String, Boolean)

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Source:: TarFile.cs

Extrait le contenu d’un fichier tar dans le répertoire spécifié.

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 -> unit

Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

Paramètres

sourceFileName: String

Chemin du fichier tar à extraire.

destinationDirectoryName: String

overwriteFiles: Boolean

Exceptions

ArgumentNullException

sourceFileName ou destinationDirectoryName est null.

DirectoryNotFoundException

.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.

FileNotFoundException

Le sourceFileName chemin d’accès au fichier est introuvable.

UnauthorizedAccessException

Les autorisations sont insuffisantes.

ArgumentException

L’extraction de l’une des entrées tar aurait entraîné un fichier en dehors du répertoire de destination spécifié.

- ou -

sourceFileName ou destinationDirectoryName est vide.

InvalidDataException

.NET 11 et versions ultérieures uniquement : la somme de contrôle d'une entrée n'est pas valide.

IOException

Une exception d’E/S s’est produite.

Remarques

Warning

Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.

Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.

L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.

S’applique à

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 -> unit

Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)

Paramètres

sourceFileName: String

destinationDirectoryName: String

options: TarExtractOptions

Exceptions

DirectoryNotFoundException

.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.

Remarques

Warning

Le chemin peut être relatif ou absolu. Un chemin relatif est interprété comme relatif au répertoire de travail actuel.

Si une erreur se produit lors de l’extraction, l’archive reste partiellement extraite.

Définissez cette option OverwriteFiles pour true remplacer les fichiers existants. La valeur par défaut est false. Permet HardLinkMode de contrôler l’extraction des entrées de lien dur.

Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.

Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.

L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.

S’applique à

Commentaires

Cette page a-t-elle été utile ?