ZipArchiveMode ZipArchiveMode ZipArchiveMode ZipArchiveMode Enum

Definition

Gibt Werte für die Interaktion mit Zip-Archiveinträgen an.Specifies values for interacting with zip archive entries.

public enum class ZipArchiveMode
public enum ZipArchiveMode
type ZipArchiveMode = 
Public Enum ZipArchiveMode
Vererbung
ZipArchiveModeZipArchiveModeZipArchiveModeZipArchiveMode

Felder

Create Create Create Create 1

Nur das Erstellen neuer Archiveinträge ist zulässig.Only creating new archive entries is permitted.

Read Read Read Read 0

Nur das Lesen von Archiveinträgen ist zulässig.Only reading archive entries is permitted.

Update Update Update Update 2

Lese- und Schreibvorgänge sind für die Archiveinträge zulässig.Both read and write operations are permitted for archive entries.

Beispiele

Das folgende Beispiel zeigt, wie eine ZipArchiveMode Wert beim Erstellen einer ZipArchive.ZipArchive(Stream, ZipArchiveMode) Objekt.The following example shows how to specify a ZipArchiveMode value when creating a ZipArchive.ZipArchive(Stream, ZipArchiveMode) object.

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

Hinweise

Beim Festlegen des Modus auf lesen, die zugrunde liegende Datei oder den Stream Lesevorgänge unterstützt werden muss, aber keine Suchvorgänge unterstützt.When you set the mode to Read, the underlying file or stream must support reading, but does not have to support seeking. Wenn die zugrunde liegende Datei oder den Stream Suchvorgänge unterstützt, werden die Dateien aus dem Archiv gelesen, wie sie angefordert werden.If the underlying file or stream supports seeking, the files are read from the archive as they are requested. Die zugrunde liegende Datei oder den Stream keine Suchvorgänge unterstützt, wird im Arbeitsspeicher des kompletten Archivs aufrechterhalten.If the underlying file or stream does not support seeking, the entire archive is held in memory.

Beim Festlegen des Modus zum Erstellen der zugrunde liegenden Datei oder den Stream muss Unterstützung für das Schreiben, jedoch keine Suchvorgänge unterstützt.When you set the mode to Create, the underlying file or stream must support writing, but does not have to support seeking. Jeder Eintrag im Archiv kann nur einmal zum Schreiben geöffnet werden.Each entry in the archive can be opened only once for writing. Wenn Sie einen einzelnen Eintrag erstellen, werden die Daten auf die zugrunde liegende Stream oder eine Datei geschrieben, sobald es verfügbar ist.If you create a single entry, the data is written to the underlying stream or file as soon as it is available. Bei der Erstellung von mehreren Einträgen, z. B. durch Aufrufen der CreateFromDirectory -Methode, die Daten geschrieben in der zugrunde liegenden Stream oder eine Datei nach der alle Einträge erstellt werden.If you create multiple entries, such as by calling the CreateFromDirectory method, the data is written to the underlying stream or file after all the entries are created.

Wenn Sie den Modus auf Update festlegen, muss die zugrunde liegende Datei oder den Stream unterstützen, lesen, schreiben und gesucht werden soll.When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. Der Inhalt des kompletten Archivs wird im Arbeitsspeicher gehalten, und keine Daten in die zugrunde liegende Datei oder den Stream geschrieben werden, bis das Archiv verworfen wird.The content of the entire archive is held in memory, and no data is written to the underlying file or stream until the archive is disposed.

Die folgenden Methoden enthalten einen Parameter, die mit dem Namen mode , mit der Angabe der Archivmodus:The following methods include a parameter named mode that lets you specify the archive mode:

Gilt für: