ZipArchiveMode ZipArchiveMode ZipArchiveMode ZipArchiveMode Enum

Определение

Определяет значения для взаимодействия с записями ZIP-архива.Specifies values for interacting with zip archive entries.

public enum class ZipArchiveMode
public enum ZipArchiveMode
type ZipArchiveMode = 
Public Enum ZipArchiveMode
Наследование
ZipArchiveModeZipArchiveModeZipArchiveModeZipArchiveMode

Поля

Create Create Create Create 1

Разрешено только создание новых записей архива.Only creating new archive entries is permitted.

Read Read Read Read 0

Разрешено только чтение записей архива.Only reading archive entries is permitted.

Update Update Update Update 2

Операции чтение и запись разрешены для записей архива.Both read and write operations are permitted for archive entries.

Примеры

В следующем примере показано, как указать ZipArchiveMode значение при создании ZipArchive.ZipArchive(Stream, ZipArchiveMode) объекта.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

Комментарии

Если выбран режим для чтения основной файл или поток должен поддерживать чтение, но не поддерживает поиск.When you set the mode to Read, the underlying file or stream must support reading, but does not have to support seeking. Если основной файл или поток поддерживает поиск, файлы доступны для чтения из архива по запросу.If the underlying file or stream supports seeking, the files are read from the archive as they are requested. Если основной файл или поток не поддерживает поиск, весь архив хранится в памяти.If the underlying file or stream does not support seeking, the entire archive is held in memory.

Если выбран режим Создание основной файл или поток должен поддерживать запись, но не поддерживает поиск.When you set the mode to Create, the underlying file or stream must support writing, but does not have to support seeking. Каждая запись в архиве можно открыть только один раз для записи.Each entry in the archive can be opened only once for writing. Если создается одна запись, данные записываются в основной поток или файл, как только он доступен.If you create a single entry, the data is written to the underlying stream or file as soon as it is available. Если создать несколько записей, например, вызвав CreateFromDirectory метод, данные записываются в базовый поток или файл после создания всех записей.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.

Если выбран режим для обновления основной файл или поток должен поддерживать чтение, запись и поиск.When you set the mode to Update, the underlying file or stream must support reading, writing, and seeking. Весь архив содержимое хранится в памяти, и данные не записываются в базовый файл или поток до уничтожения архива.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.

Следующие методы включают параметр с именем mode , позволяющий указать режим архива:The following methods include a parameter named mode that lets you specify the archive mode:

Применяется к