TarEntry.ExtractToFile(String, Boolean) Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Zdroj:

TarEntry.cs

Extrahuje aktuální soubor nebo adresář do systému souborů. Symbolické odkazy a pevné odkazy nejsou extrahovány.

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)

Parametry

destinationFileName

String

Cesta k cílovému souboru.

overwrite

Boolean

true pokud by tato metoda měla přepsat jakýkoli existující objekt systému souborů umístěný v destinationFileName cestě, false aby se zabránilo přepsání.

Výjimky

ArgumentNullException

destinationFileName je null.

ArgumentException

destinationFileName je prázdný.

IOException

Nadřazený adresář neexistuje destinationFileName .

-nebo-

overwrite je false a soubor již v destinationFileNamesystému existuje.

-nebo-

Existuje adresář se stejným názvem jako destinationFileName.

-nebo-

Došlo k problému se vstupně-výstupními operacemi.

InvalidOperationException

Došlo k pokusu o extrahování symbolického odkazu, pevného odkazu nebo nepodporovaného typu položky.

UnauthorizedAccessException

Operace není povolena kvůli nedostatečným oprávněním.

Poznámky

Soubory typu BlockDevice, CharacterDevicenebo Fifo lze extrahovat pouze v unixových platformách.

K extrahování BlockDevice nebo CharacterDevice na disk se vyžaduje zvýšení oprávnění.

Symbolické odkazy lze znovu vytvořit pomocí CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)nebo CreateAsSymbolicLink(String).

Pevné odkazy lze extrahovat pouze při použití nebo ExtractToDirectory(Stream, String, Boolean)ExtractToDirectory(String, String, Boolean).