ZipArchiveMode ZipArchiveMode ZipArchiveMode ZipArchiveMode Enum

Definizione

Specifica i valori per l'interazione con le voci dell'archivio ZIP.Specifies values for interacting with zip archive entries.

public enum class ZipArchiveMode
public enum ZipArchiveMode
type ZipArchiveMode = 
Public Enum ZipArchiveMode
Ereditarietà
ZipArchiveModeZipArchiveModeZipArchiveModeZipArchiveMode

Campi

Create Create Create Create 1

È consentita solo la creazione di nuove voci dell'archivio.Only creating new archive entries is permitted.

Read Read Read Read 0

È consentita solo la lettura delle voci dell'archivio.Only reading archive entries is permitted.

Update Update Update Update 2

Sono consentite sia operazioni in lettura che in scrittura per le voci dell'archivio.Both read and write operations are permitted for archive entries.

Esempi

Nell'esempio seguente viene illustrato come specificare una ZipArchiveMode valore durante la creazione di un ZipArchive.ZipArchive(Stream, ZipArchiveMode) oggetto.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

Commenti

Quando si imposta la modalità di lettura, file o nel flusso sottostante deve supportare la lettura, ma non deve supportare la ricerca.When you set the mode to Read, the underlying file or stream must support reading, but does not have to support seeking. Se il file o flusso sottostante supporta la ricerca, i file vengono letti dall'archivio quando vengono richiesti.If the underlying file or stream supports seeking, the files are read from the archive as they are requested. Se il file o flusso sottostante non supporta la ricerca, l'intero archivio viene mantenuto in memoria.If the underlying file or stream does not support seeking, the entire archive is held in memory.

Quando si imposta la modalità di creazione, file o nel flusso sottostante deve supportare la scrittura, ma non deve supportare la ricerca.When you set the mode to Create, the underlying file or stream must support writing, but does not have to support seeking. Ogni voce nell'archivio può essere aperto solo una volta per la scrittura.Each entry in the archive can be opened only once for writing. Se si crea un'unica voce, i dati vengono scritti nel file o il flusso sottostante, non appena è disponibile.If you create a single entry, the data is written to the underlying stream or file as soon as it is available. Se si creano più voci, ad esempio chiamando il CreateFromDirectory (metodo), i dati vengono scritti nel file o il flusso sottostante dopo che tutte le voci vengono create.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.

Quando si imposta la modalità di aggiornamento, file o nel flusso sottostante deve supportare la lettura, scrittura e la ricerca.When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. Il contenuto dell'intero archivio viene mantenuto in memoria e nessun dato viene scritto il file o nel flusso sottostante di fino a quando l'archivio viene eliminato.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.

I metodi seguenti includono un parametro denominato mode che consente di specificare la modalità di archiviazione:The following methods include a parameter named mode that lets you specify the archive mode:

Si applica a