ZipArchiveMode ZipArchiveMode ZipArchiveMode ZipArchiveMode Enum

Définition

Spécifie les valeurs pour interagir avec les entrées d'archive ZIP.Specifies values for interacting with zip archive entries.

public enum class ZipArchiveMode
public enum ZipArchiveMode
type ZipArchiveMode = 
Public Enum ZipArchiveMode
Héritage
ZipArchiveModeZipArchiveModeZipArchiveModeZipArchiveMode

Champs

Create Create Create Create 1

Seule la création d’entrées d’archivage est autorisée.Only creating new archive entries is permitted.

Read Read Read Read 0

Seule la lecture des entrées d’archivage est autorisée.Only reading archive entries is permitted.

Update Update Update Update 2

Les opérations de lecture et d’écriture sont autorisées pour les entrées d’archivage.Both read and write operations are permitted for archive entries.

Exemples

L’exemple suivant montre comment spécifier une ZipArchiveMode valeur lors de la création d’un ZipArchive.ZipArchive(Stream, ZipArchiveMode) objet.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

Remarques

Lorsque vous définissez le mode sur lecture, le fichier ou le flux sous-jacent doit prendre en charge la lecture, mais il n’est pas nécessaire de prendre en charge la recherche.When you set the mode to Read, the underlying file or stream must support reading, but does not have to support seeking. Si le fichier ou le flux sous-jacent prend en charge la recherche, les fichiers sont lus à partir de l’archive lorsqu’ils sont demandés.If the underlying file or stream supports seeking, the files are read from the archive as they are requested. Si le fichier ou le flux sous-jacent ne prend pas en charge la recherche, la totalité de l’archive est conservée en mémoire.If the underlying file or stream does not support seeking, the entire archive is held in memory.

Lorsque vous définissez le mode sur créer, le fichier ou le flux sous-jacent doit prendre en charge l’écriture, mais il n’est pas nécessaire de prendre en charge la recherche.When you set the mode to Create, the underlying file or stream must support writing, but does not have to support seeking. Chaque entrée de l’archive ne peut être ouverte qu’une seule fois pour l’écriture.Each entry in the archive can be opened only once for writing. Si vous créez une seule entrée, les données sont écrites dans le flux ou le fichier sous-jacent dès qu’elles sont disponibles.If you create a single entry, the data is written to the underlying stream or file as soon as it is available. Si vous créez plusieurs entrées, par exemple en appelant la CreateFromDirectory méthode, les données sont écrites dans le flux ou le fichier sous-jacent une fois toutes les entrées créées.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.

Lorsque vous définissez le mode sur Update, le fichier ou le flux sous-jacent doit prendre en charge la lecture, l’écriture et la recherche.When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. Le contenu de l’archive entière est conservé en mémoire et aucune donnée n’est écrite dans le fichier ou le flux sous-jacent tant que l’archive n’est pas supprimée.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.

Les méthodes suivantes incluent un paramètre nommé mode qui vous permet de spécifier le mode d’archivage:The following methods include a parameter named mode that lets you specify the archive mode:

S’applique à