ZipFile.ExtractToDirectory Methode

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName);

static member ExtractToDirectory : string * string -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String)

Parameters

Uitzonderingen

Voorbeelden

In dit voorbeeld ziet u hoe u een zip-archief maakt en extraheert met behulp van de ZipFile klasse. Het comprimeert de inhoud van een map in een zip-archief en extraheert die inhoud naar een nieuwe map. Als u de ZipFile klasse wilt gebruiken, moet u verwijzen naar de System.IO.Compression.FileSystem assembly in uw project.

using System;
using System.IO.Compression;

class Program
{
    static void Main(string[] args)
    {
        string startPath = @".\start";
        string zipPath = @".\result.zip";
        string extractPath = @".\extract";

        ZipFile.CreateFromDirectory(startPath, zipPath);

        ZipFile.ExtractToDirectory(zipPath, extractPath);
    }
}

open System.IO.Compression

let startPath = @".\start"
let zipPath = @".\result.zip"
let extractPath = @".\extract"

ZipFile.CreateFromDirectory(startPath, zipPath)

ZipFile.ExtractToDirectory(zipPath, extractPath)

Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = ".\start"
        Dim zipPath As String = ".\result.zip"
        Dim extractPath As String = ".\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Opmerkingen

Met deze methode worden de opgegeven map en alle submappen gemaakt. De doelmap kan niet al bestaan. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of sourceArchiveFileName parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.

Als een vermelding in het zip-archief een symbolische koppeling is, wordt deze geëxtraheerd als een gewone map, omdat symbolische koppelingsgegevens niet behouden blijven in de ZIP-indeling. Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : string * string * bool -> unit

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

Parameters

Uitzonderingen

Opmerkingen

Als er een fout optreedt tijdens het extraheren van het archief, blijft het archief gedeeltelijk geëxtraheerd.

Elke vermelding wordt geëxtraheerd, zodat het uitgepakte bestand hetzelfde relatieve pad heeft als destinationDirectoryName de vermelding in het archief.

De sourceArchiveFileName parameters destinationDirectoryName accepteren zowel relatieve als absolute paden. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.

Als een vermelding in het zip-archief een symbolische koppeling is, wordt deze geëxtraheerd als een gewone map, omdat symbolische koppelingsgegevens niet behouden blijven in de ZIP-indeling. Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding);

static member ExtractToDirectory : string * string * System.Text.Encoding -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding)

Parameters

Uitzonderingen

Opmerkingen

Met deze methode worden de opgegeven map en alle submappen gemaakt, indien nodig. Uitzonderingen met betrekking tot het valideren van de paden in de destinationDirectoryName of sourceArchiveFileName parameters worden gegenereerd vóór extractie. Als er anders een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd. Elk uitgepakt bestand heeft hetzelfde relatieve pad naar de map die is destinationDirectoryName opgegeven als de bronvermelding, moet in de hoofdmap van het archief staan.

Als een vermelding in het zip-archief een symbolische koppeling is, wordt deze geëxtraheerd als een gewone map, omdat symbolische koppelingsgegevens niet behouden blijven in de ZIP-indeling. Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

Als entryNameEncoding deze is ingesteld op een andere waarde dan null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:

• Voor vermeldingen waarbij de taalcoderingsvlag (in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst) niet is ingesteld, worden de invoernamen en opmerkingen gedecodeerd met behulp van de opgegeven codering.
• Voor vermeldingen waarin de vlag voor taalcodering is ingesteld, worden de invoernamen en opmerkingen gedecodeerd met behulp van UTF-8.

Als entryNameEncoding deze optie is ingesteld null, worden invoernamen en opmerkingen gedecodeerd volgens de volgende regels:

• Voor vermeldingen waarin de taalcoderingsvlag (in de bitvlag voor algemeen gebruik van de lokale bestandskoptekst) niet is ingesteld, worden invoernamen en opmerkingen gedecodeerd met behulp van de huidige standaardcodepagina van het systeem.
• Voor vermeldingen waarin de vlag voor taalcodering is ingesteld, worden de invoernamen en opmerkingen gedecodeerd met behulp van UTF-8.

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding, bool overwriteFiles);

static member ExtractToDirectory : string * string * System.Text.Encoding * bool -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)

Parameters

Uitzonderingen

Opmerkingen

Als er een fout optreedt tijdens het extraheren van het archief, blijft het archief gedeeltelijk geëxtraheerd.

Elke vermelding wordt geëxtraheerd, zodat het uitgepakte bestand hetzelfde relatieve pad heeft als destinationDirectoryName de vermelding in het archief.

De sourceArchiveFileName parameters destinationDirectoryName accepteren zowel relatieve als absolute paden. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.

Als een vermelding in het zip-archief een symbolische koppeling is, wordt deze geëxtraheerd als een gewone map, omdat symbolische koppelingsgegevens niet behouden blijven in de ZIP-indeling. Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

Als een te archiveren bestand een ongeldige datum en tijd heeft die voor het laatst is gewijzigd, wordt de eerste datum en tijd in de indeling van de zip-tijdstempel (middernacht op 1 januari 1980) gebruikt.