TarEntry.ExtractToFile(String, Boolean) Methode

Definition

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Quelle:

TarEntry.cs

Extrahiert die aktuelle Datei oder das aktuelle Verzeichnis in das Dateisystem. Symbolische Links und feste Links werden nicht extrahiert.

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)

Parameter

destinationFileName

String

Der Pfad zur Zieldatei.

overwrite

Boolean

true , wenn diese Methode ein vorhandenes Dateisystemobjekt im destinationFileName Pfad überschreiben soll, false um das Überschreiben zu verhindern.

Ausnahmen

ArgumentNullException

destinationFileName ist null.

ArgumentException

destinationFileName ist leer.

IOException

Das übergeordnete Verzeichnis von destinationFileName ist nicht vorhanden.

Oder

overwriteist und eine Datei bereits in destinationFileNamevorhanden istfalse.

Oder

Ein Verzeichnis mit demselben Namen wie destinationFileNameist vorhanden.

Oder

Ein E/A-Problem ist aufgetreten.

InvalidOperationException

Es wurde versucht, einen symbolischen Link, eine feste Verknüpfung oder einen nicht unterstützten Eintragstyp zu extrahieren.

UnauthorizedAccessException

Der Vorgang ist aufgrund unzureichender Berechtigungen nicht zulässig.

Hinweise

Dateien vom Typ BlockDevice, CharacterDeviceoder Fifo können nur auf Unix-Plattformen extrahiert werden.

Die Rechteerweiterung ist erforderlich, um einen BlockDevice oder CharacterDevice auf den Datenträger zu extrahieren.

Symbolische Verknüpfungen können mit CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)oder CreateAsSymbolicLink(String)neu erstellt werden.

Feste Links können nur extrahiert werden, wenn oder ExtractToDirectory(String, String, Boolean)verwendet ExtractToDirectory(Stream, String, Boolean) wird.