ZipFileExtensions.ExtractToFile Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.ZipFile.dll

Zip arşivindeki bir girdiyi bir dosyaya ayıklar.

Aşırı Yüklemeler

ExtractToFile(ZipArchiveEntry, String)	Zip arşivindeki bir girdiyi bir dosyaya ayıklar.
ExtractToFile(ZipArchiveEntry, String, Boolean)	Zip arşivindeki bir girdiyi bir dosyaya ayıklar ve isteğe bağlı olarak aynı ada sahip mevcut bir dosyanın üzerine yazar.

ExtractToFile(ZipArchiveEntry, String)

Kaynak:

ZipFileExtensions.ZipArchiveEntry.Extract.cs

Zip arşivindeki bir girdiyi bir dosyaya ayıklar.

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToFile(System::IO::Compression::ZipArchiveEntry ^ source, System::String ^ destinationFileName);

public static void ExtractToFile (this System.IO.Compression.ZipArchiveEntry source, string destinationFileName);

static member ExtractToFile : System.IO.Compression.ZipArchiveEntry * string -> unit

<Extension()>
Public Sub ExtractToFile (source As ZipArchiveEntry, destinationFileName As String)

Parametreler

source

ZipArchiveEntry

Dosyasının ayıklanması için zip arşiv girdisi.

destinationFileName

String

Girdinin içeriğinden oluşturulacak dosyanın yolu. Göreli veya mutlak bir yol belirtebilirsiniz. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

Özel durumlar

ArgumentException

destinationFileName sıfır uzunluklu bir dizedir, yalnızca boşluk içerir veya tarafından InvalidPathCharstanımlanan bir veya daha fazla geçersiz karakter içerir.

-veya-

destinationFileName bir dizin belirtir.

ArgumentNullException

destinationFileName, null değeridir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

destinationFileName zaten var.

-veya-

G/ç hatası oluştu.

-veya-

Girdi şu anda yazmak için açık.

-veya-

Girdi arşivden silindi.

UnauthorizedAccessException

Çağıranın yeni dosyayı oluşturmak için gerekli izni yok.

InvalidDataException

Girdi arşivde eksik veya bozuk ve okunamıyor.

-veya-

Giriş, desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

ObjectDisposedException

Bu girdinin ait olduğu zip arşivi atılmış.

NotSupportedException

destinationFileName geçersiz biçimde.

-veya-

Bu girdinin zip arşivi, girdilerin alınmasına izin vermeyen modda Create açıldı.

Örnekler

Aşağıdaki örnekte, zip arşiv dosyasının içeriğinde yineleme ve .txt uzantısına sahip dosyaları ayıklama gösterilmektedir.

using System;
using System.IO;
using System.IO.Compression;

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

        Console.WriteLine("Provide path where to extract the zip file:");
        string extractPath = Console.ReadLine();

        // Normalizes the path.
        extractPath = Path.GetFullPath(extractPath);

        // Ensures that the last character on the extraction path
        // is the directory separator char.
        // Without this, a malicious zip file could try to traverse outside of the expected
        // extraction path.
        if (!extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal))
            extractPath += Path.DirectorySeparatorChar;

        using (ZipArchive archive = ZipFile.OpenRead(zipPath))
        {
            foreach (ZipArchiveEntry entry in archive.Entries)
            {
                if (entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase))
                {
                    // Gets the full path to ensure that relative segments are removed.
                    string destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName));

                    // Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    // are case-insensitive.
                    if (destinationPath.StartsWith(extractPath, StringComparison.Ordinal))
                        entry.ExtractToFile(destinationPath);
                }
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = ".\result.zip"

        Console.WriteLine("Provide path where to extract the zip file:")
        Dim extractPath As String = Console.ReadLine()

        ' Normalizes the path.
        extractPath = Path.GetFullPath(extractPath)

        ' Ensures that the last character on the extraction path
        ' is the directory separator char. 
        ' Without this, a malicious zip file could try to traverse outside of the expected
        ' extraction path.
        If Not extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal) Then
            extractPath += Path.DirectorySeparatorChar
        End If

        Using archive As ZipArchive = ZipFile.OpenRead(zipPath)
            For Each entry As ZipArchiveEntry In archive.Entries
                If entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase) Then

                    ' Gets the full path to ensure that relative segments are removed.
                    Dim destinationPath As String = Path.GetFullPath(Path.Combine(extractPath, entry.FullName))
                    
                    ' Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    ' are case-insensitive.
                    If destinationPath.StartsWith(extractPath, StringComparison.Ordinal) Then 
                        entry.ExtractToFile(destinationPath)
                    End If

                End If
            Next
        End Using
    End Sub

End Module

Açıklamalar

Hedef dosya zaten varsa, bu yöntem dosyanın üzerine yazmaz; bir IOException özel durum oluşturur. Varolan bir dosyanın üzerine yazmak için bunun yerine yöntem aşırı yüklemesini ExtractToFile(ZipArchiveEntry, String, Boolean) kullanın.

Dosyanın son yazma zamanı, zip arşivindeki girdinin son değiştirildiği zamana ayarlanır; bu değer özelliğinde LastWriteTime depolanır.

Dizin ayıklamak için bu yöntemi kullanamazsınız; ExtractToDirectory bunun yerine yöntemini kullanın.

ExtractToFile(ZipArchiveEntry, String, Boolean)

Kaynak:

ZipFileExtensions.ZipArchiveEntry.Extract.cs

Zip arşivindeki bir girdiyi bir dosyaya ayıklar ve isteğe bağlı olarak aynı ada sahip mevcut bir dosyanın üzerine yazar.

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToFile(System::IO::Compression::ZipArchiveEntry ^ source, System::String ^ destinationFileName, bool overwrite);

public static void ExtractToFile (this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite);

static member ExtractToFile : System.IO.Compression.ZipArchiveEntry * string * bool -> unit

<Extension()>
Public Sub ExtractToFile (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean)

Parametreler

source

ZipArchiveEntry

Dosyasının ayıklanması için zip arşiv girdisi.

destinationFileName

String

Girdinin içeriğinden oluşturulacak dosyanın yolu. Göreli veya mutlak bir yol belirtebilirsiniz. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

overwrite

Boolean

true hedef dosyayla aynı ada sahip mevcut bir dosyanın üzerine yazmak için; aksi takdirde , false.

Özel durumlar

ArgumentException

destinationFileName sıfır uzunluklu bir dizedir, yalnızca boşluk içerir veya tarafından InvalidPathCharstanımlanan bir veya daha fazla geçersiz karakter içerir.

-veya-

destinationFileName bir dizin belirtir.

ArgumentNullException

destinationFileName, null değeridir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

destinationFileName zaten var ve overwrite şeklindedir false.

-veya-

G/ç hatası oluştu.

-veya-

Girdi şu anda yazmak için açık.

-veya-

Girdi arşivden silindi.

UnauthorizedAccessException

Çağıranın yeni dosyayı oluşturmak için gerekli izni yok.

InvalidDataException

Girdi arşivde eksik veya bozuk ve okunamıyor.

-veya-

Giriş, desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

ObjectDisposedException

Bu girdinin ait olduğu zip arşivi atılmış.

NotSupportedException

destinationFileName geçersiz biçimde.

-veya-

Bu girdinin zip arşivi, girdilerin alınmasına izin vermeyen modda Create açıldı.

Örnekler

Aşağıdaki örnekte zip arşiv dosyasının içeriğinde yineleme ve .txt uzantısına sahip dosyaları ayıklama gösterilmektedir. Hedef klasörde aynı ada sahip mevcut bir dosyanın üzerine yazar. Bu kod örneğini derleyicik için projenizdeki ve System.IO.Compression.FileSystem derlemelerine başvurmanız System.IO.Compression gerekir.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\example\start.zip";

            Console.WriteLine("Provide path where to extract the zip file:");
            string extractPath = Console.ReadLine();

            // Normalizes the path.
            extractPath = Path.GetFullPath(extractPath);

            // Ensures that the last character on the extraction path
            // is the directory separator char.
            // Without this, a malicious zip file could try to traverse outside of the expected
            // extraction path.
            if (!extractPath.EndsWith(Path.DirectorySeparatorChar))
                extractPath += Path.DirectorySeparatorChar;

            using (ZipArchive archive = ZipFile.OpenRead(zipPath))
            {
                foreach (ZipArchiveEntry entry in archive.Entries)
                {
                    if (entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase))
                    {
                        // Gets the full path to ensure that relative segments are removed.
                        string destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName));

                        // Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                        // are case-insensitive.
                        if (destinationPath.StartsWith(extractPath, StringComparison.Ordinal))
                            entry.ExtractToFile(destinationPath, true);
                    }
                }
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\example\start.zip"

        Console.WriteLine("Provide path where to extract the zip file:")
        Dim extractPath As String = Console.ReadLine()

        ' Normalizes the path.
        extractPath = Path.GetFullPath(extractPath)

        ' Ensures that the last character on the extraction path
        ' is the directory separator char. 
        ' Without this, a malicious zip file could try to traverse outside of the expected
        ' extraction path.
        If Not extractPath.EndsWith(Path.DirectorySeparatorChar) Then
            extractPath += Path.DirectorySeparatorChar
        End If

        Using archive As ZipArchive = ZipFile.OpenRead(zipPath)
            For Each entry As ZipArchiveEntry In archive.Entries
                If entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase) Then

                    ' Gets the full path to ensure that relative segments are removed.
                    Dim destinationPath As String = Path.GetFullPath(Path.Combine(extractPath, entry.FullName))
                    
                    ' Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    ' are case-insensitive.
                    If destinationPath.StartsWith(extractPath, StringComparison.Ordinal) Then 
                        entry.ExtractToFile(destinationPath, true)
                    End If

                End If
            Next
        End Using
    End Sub

End Module

Açıklamalar

Dosyanın son yazma zamanı, zip arşivindeki girdinin son değiştirildiği zamana ayarlanır; bu değer özelliğinde LastWriteTime depolanır.

Dizin ayıklamak için bu yöntemi kullanamazsınız; ExtractToDirectory bunun yerine yöntemini kullanın.