ZipFileExtensions Sınıf

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.ZipFile.dll

Kaynak:

ZipFileExtensions.ZipArchive.Create.cs

ve ZipArchiveEntry sınıfları için ZipArchive uzantı yöntemleri sağlar.

public ref class ZipFileExtensions abstract sealed

public static class ZipFileExtensions

type ZipFileExtensions = class

Public Module ZipFileExtensions

Devralma

Object

ZipFileExtensions

Açıklamalar

ZipFileExtensions sınıfı yalnızca ve ZipArchiveEntry sınıflarını genişleten ZipArchive statik yöntemler içerir. Sınıfının bir örneğini ZipFileExtensions oluşturmazsınız; bunun yerine, veya ZipArchiveEntryörneklerinden ZipArchive bu yöntemleri kullanırsınız.

Uzantı yöntemlerini kullanmak için projenizdeki derlemeye System.IO.Compression.FileSystem başvurmanız gerekir. Derleme System.IO.Compression.FileSystem Windows 8.x Store uygulamalarında kullanılamaz. Bu nedenle, ZipFileExtensions ve ZipFile sınıfları (her ikisi de derlemededirSystem.IO.Compression.FileSystem) Windows 8.x Store uygulamalarında kullanılamaz. Windows 8.x Store uygulamalarında, , , ZipArchiveEntryDeflateStreamve GZipStreamiçindeki yöntemleri ZipArchivekullanarak sıkıştırılmış dosyalarla çalışırsınız.

sınıfı, ZipFileExtensions öğesini genişleten ZipArchivedört yöntem içerir:

• CreateEntryFromFile(ZipArchive, String, String)

• CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

• ExtractToDirectory(ZipArchive, String)

• ExtractToDirectory(ZipArchive, String, Boolean)

sınıfı, ZipFileExtensions öğesini genişleten ZipArchiveEntryiki yöntem içerir:

• ExtractToFile(ZipArchiveEntry, String)

• ExtractToFile(ZipArchiveEntry, String, Boolean)

Örnekler

Aşağıdaki örnekte, mevcut bir dosyadan zip arşivinde yeni bir girdi oluşturma ve arşivin içeriğini dizine ayıklama gösterilmektedir.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Aşağıdaki örnekte zip arşivinin 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

Yöntemler

CreateEntryFromFile(ZipArchive, String, String)	Dosyayı sıkıştırıp zip arşivine ekleyerek arşivler.
CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)	Bir dosyayı belirtilen sıkıştırma düzeyini kullanarak sıkıştırarak ve zip arşivine ekleyerek arşivler.
ExtractToDirectory(ZipArchive, String)	Zip arşivindeki tüm dosyaları dosya sistemindeki bir dizine ayıklar.
ExtractToDirectory(ZipArchive, String, Boolean)	Arşivdeki tüm dosyaları dosya sistemindeki bir dizine ayıklar.
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.