ZipArchiveEntry Osztály

Definíció

Névtér:

System.IO.Compression

Szerelvények:

netstandard.dll, System.IO.Compression.dll

Forrás:

ZipArchiveEntry.cs

Tömörített fájlt jelöl egy zip-archívumban.

public ref class ZipArchiveEntry

public class ZipArchiveEntry

type ZipArchiveEntry = class

Public Class ZipArchiveEntry

Öröklődés

Object

ZipArchiveEntry

Megjegyzések

A zip-archívum minden tömörített fájlhoz tartalmaz bejegyzést. Az ZipArchiveEntry osztály lehetővé teszi egy bejegyzés tulajdonságainak vizsgálatát, valamint a bejegyzés megnyitását vagy törlését. Bejegyzés megnyitásakor módosíthatja a tömörített fájlt úgy, hogy a tömörített fájl streambe ír.

A zip-archívumok és fájlbejegyzéseik manipulálásának módszerei három osztályra oszlanak: ZipFileés ZipArchiveZipArchiveEntry.

To...	Használja...
Zip-archívum létrehozása könyvtárból	ZipFile.CreateFromDirectory
Zip-archívum tartalmának kinyerése könyvtárba	ZipFile.ExtractToDirectory
Új fájlok hozzáadása meglévő zip-archívumhoz	ZipArchive.CreateEntry
Fájl lekérése zip-archívumban	ZipArchive.GetEntry
Az összes fájl lekérése zip-archívumban	ZipArchive.Entries
Stream megnyitása egy zip-archívumban található egyedi fájlba	ZipArchiveEntry.Open
Fájl törlése zip-archívumból	ZipArchiveEntry.Delete

Ha a System.IO.Compression.FileSystem projekt szerelvényére hivatkozik, az osztályhoz két bővítménymetelyt ZipArchiveEntry érhet el. Ezek a metódusok ExtractToFile(ZipArchiveEntry, String) , és ExtractToFile(ZipArchiveEntry, String, Boolean)lehetővé teszik a fájlba való bejegyzés tartalmának felbontását. A System.IO.Compression.FileSystem szerelvény nem érhető el Windows 8. Az Windows 8.x Áruházbeli alkalmazásokban DeflateStream vagy GZipStream használatával bonthatja le az archívum tartalmát, vagy a fájlok tömörítéséhez és kibontásához használhatja az Windows-futtatókörnyezet <xref:Windows.Storage.Compression.Compressor> és <xref:Windows.Storage.Compression.Decompressor> típusokat.

Példák

Az első példa bemutatja, hogyan hozhat létre új bejegyzést egy zip archívumban, és hogyan írhat hozzá.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            using (FileStream zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open))
            {
                using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
                {
                    ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt");
                    using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                    {
                            writer.WriteLine("Information about this package.");
                            writer.WriteLine("========================");
                    }
                }
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Using zipToOpen As FileStream = New FileStream("c:\users\exampleuser\release.zip", FileMode.Open)
            Using archive As ZipArchive = New ZipArchive(zipToOpen, ZipArchiveMode.Update)
                Dim readmeEntry As ZipArchiveEntry = archive.CreateEntry("Readme.txt")
                Using writer As StreamWriter = New StreamWriter(readmeEntry.Open())
                    writer.WriteLine("Information about this package.")
                    writer.WriteLine("========================")
                End Using
            End Using
        End Using
    End Sub

End Module

A második példa a bővítménymetódus ExtractToFile(ZipArchiveEntry, String) használatát mutatja be. A kód végrehajtásához hivatkoznia kell a System.IO.Compression.FileSystem projekt szerelvényére.

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

Tulajdonságok

Name	Description
Archive	Lekéri azt a zip archívumot, amelyhez a bejegyzés tartozik.
Comment	Lekéri vagy beállítja az opcionális bejegyzés megjegyzését.
CompressedLength	Lekéri a zip archívumban lévő bejegyzés tömörített méretét bájtban kifejezve.
Crc32	A 32 bites ciklikus redundáns ellenőrzés.
ExternalAttributes	Operációs rendszer- és alkalmazásspecifikus fájlattribútumok.
FullName	Lekéri a bejegyzés relatív elérési útját a zip archívumban.
IsEncrypted	Olyan értéket kap, amely jelzi, hogy a bejegyzés titkosítva van-e.
LastWriteTime	Lekéri vagy beállítja a zip-archívumban lévő bejegyzés legutóbbi módosításának időpontját.
Length	Lekéri a zip archívumban lévő bejegyzés tömörítetlen méretét bájtban kifejezve.
Name	Lekéri a bejegyzés fájlnevét a zip archívumban.

Metódusok

Name	Description
Delete()	Törli a bejegyzést a zip archívumból.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Open()	Megnyitja a bejegyzést a zip archívumból.
OpenAsync(CancellationToken)	Aszinkron módon megnyitja a bejegyzést.
ToString()	Lekéri a bejegyzés relatív elérési útját a zip archívumban.

Bővítő metódusok

Name	Description
ExtractToFile(ZipArchiveEntry, String, Boolean)	Kinyer egy bejegyzést a zip-archívumból egy fájlba, és opcionálisan felülír egy azonos nevű meglévő fájlt.
ExtractToFile(ZipArchiveEntry, String)	Kinyer egy bejegyzést a zip archívumból egy fájlba.
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)	Aszinkron módon létrehoz egy fájlt a fájlrendszeren a bejegyzés tartalmával és a megadott névvel.
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)	Aszinkron módon létrehoz egy fájlt a fájlrendszeren a bejegyzés tartalmával és a megadott névvel.