ZipArchiveMode Enumeração

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Assembly:

netstandard.dll

Especifica valores para interagir com entradas do arquivo morto zip.

public enum class ZipArchiveMode

public enum ZipArchiveMode

type ZipArchiveMode = 

Public Enum ZipArchiveMode

Herança

Object

ValueType

Enum

ZipArchiveMode

Campos

Create	1	Somente entradas de criação de novo arquivo-morto são permitidas.
Read	0	Somente entradas de leitura de arquivo-morto são permitidas.
Update	2	Ambas as operações de leitura e gravação são permitidas entradas de arquivos-mortos.

Comentários

Quando você define o modo como Leitura, o arquivo ou fluxo subjacente deve dar suporte à leitura, mas não precisa dar suporte à busca. Se o arquivo ou fluxo subjacente der suporte à busca, os arquivos serão lidos do arquivo morto conforme são solicitados. Se o arquivo ou fluxo subjacente não oferecer suporte à busca, todo o arquivo será mantido na memória.

Quando você define o modo como Criar, o arquivo ou fluxo subjacente deve dar suporte à gravação, mas não precisa dar suporte à busca. Cada entrada no arquivo morto pode ser aberta apenas uma vez para gravação. Se você criar uma única entrada, os dados serão gravados no fluxo ou arquivo subjacente assim que estiverem disponíveis. Se você criar várias entradas, como chamando o CreateFromDirectory método, os dados serão gravados no fluxo ou arquivo subjacente depois que todas as entradas forem criadas.

Quando você define o modo como Atualizar, o arquivo ou fluxo subjacente deve dar suporte à leitura, gravação e busca. O conteúdo do arquivo inteiro é mantido na memória e nenhum dado é gravado no arquivo ou fluxo subjacente até que o arquivo seja descartado.

Os métodos a seguir incluem um parâmetro nomeado mode que permite especificar o modo de arquivo morto:

• ZipArchive.ZipArchive(Stream, ZipArchiveMode, Boolean)

• ZipArchive.ZipArchive(Stream, ZipArchiveMode)

• ZipFile.Open(String, ZipArchiveMode)

Exemplos

O exemplo a seguir mostra como especificar um ZipArchiveMode valor ao criar um ZipArchive objeto.

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