Partager via


TarEntry.ExtractToFile(String, Boolean) Méthode

Définition

Extrait le fichier ou le répertoire actif dans le système de fichiers. Les liens symboliques et les liens physiques ne sont pas extraits.

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)

Paramètres

destinationFileName
String

Chemin d’accès au fichier de destination.

overwrite
Boolean

true si cette méthode doit remplacer tout objet de système de fichiers existant situé dans le chemin d’accès destinationFileName ; false pour empêcher le remplacement.

Exceptions

destinationFileName a la valeur null.

destinationFileName est vide.

Le répertoire parent de n’existe destinationFileName pas.

-ou-

overwrite est false et un fichier existe déjà dans destinationFileName.

-ou-

Il existe un répertoire portant le même nom que destinationFileName.

-ou-

Un problème d’E/S s’est produit.

Tentative d’extraction d’un lien symbolique, d’un lien physique ou d’un type d’entrée non pris en charge.

Opération non autorisée en raison d’autorisations insuffisantes.

Remarques

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

Une élévation est nécessaire pour extraire un BlockDevice ou CharacterDevice sur le disque.

Les liens symboliques peuvent être recréés à l’aide CreateSymbolicLink(String, String)de , CreateSymbolicLink(String, String)ou CreateAsSymbolicLink(String).

Les liens durs ne peuvent être extraits que lors de l’utilisation de ExtractToDirectory(Stream, String, Boolean) ou ExtractToDirectory(String, String, Boolean).

S’applique à