ZipFile.Open Método

public:
 static System::IO::Compression::ZipArchive ^ Open(System::String ^ archiveFileName, System::IO::Compression::ZipArchiveMode mode);

public static System.IO.Compression.ZipArchive Open(string archiveFileName, System.IO.Compression.ZipArchiveMode mode);

static member Open : string * System.IO.Compression.ZipArchiveMode -> System.IO.Compression.ZipArchive

Public Shared Function Open (archiveFileName As String, mode As ZipArchiveMode) As ZipArchive

Parâmetros

Retornos

O arquivo zip aberto.

Exceções

Exemplos

O exemplo a seguir mostra como abrir um arquivo zip no modo de atualização e adicionar uma entrada ao arquivo morto.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

open System.IO.Compression

let zipPath = @"c:\users\exampleuser\start.zip"
let extractPath = @"c:\users\exampleuser\extract"
let newFile = @"c:\users\exampleuser\NewFile.txt"

do
    use archive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
    archive.CreateEntryFromFile(newFile, "NewEntry.txt") |> ignore
    archive.ExtractToDirectory extractPath

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Comentários

Quando você define o mode parâmetro como Read, o arquivo morto é aberto com Open a FileMode enumeração como o valor do modo de arquivo. Se o arquivo morto não existir, uma FileNotFoundException exceção será gerada. Definir o mode parâmetro Read é equivalente a chamar o OpenRead método.

Quando você define o mode parâmetro como Create, o arquivo morto é aberto como FileMode.CreateNew o valor do modo de arquivo. Se o arquivo já existir, um IOException será gerado.

Quando você define o mode parâmetro como Update, o arquivo morto é aberto como FileMode.OpenOrCreate o valor do modo de arquivo. Se o arquivo existir, ele será aberto. As entradas existentes podem ser modificadas e novas entradas podem ser criadas. Se o arquivo morto não existir, um novo arquivo será criado; no entanto, a criação de um arquivo zip no Update modo não é tão eficiente quanto criá-lo no Create modo.

public:
 static System::IO::Compression::ZipArchive ^ Open(System::String ^ archiveFileName, System::IO::Compression::ZipArchiveMode mode, System::Text::Encoding ^ entryNameEncoding);

public static System.IO.Compression.ZipArchive Open(string archiveFileName, System.IO.Compression.ZipArchiveMode mode, System.Text.Encoding entryNameEncoding);

static member Open : string * System.IO.Compression.ZipArchiveMode * System.Text.Encoding -> System.IO.Compression.ZipArchive

Public Shared Function Open (archiveFileName As String, mode As ZipArchiveMode, entryNameEncoding As Encoding) As ZipArchive

Parâmetros

Retornos

O arquivo zip aberto.

Exceções

Comentários

Quando você define o mode parâmetro como Read, o arquivo morto é aberto como FileMode.Open o valor do modo de arquivo. Se o arquivo morto não existir, uma FileNotFoundException exceção será gerada. Definir o mode parâmetro Read é equivalente a chamar o OpenRead método.

Quando você define o mode parâmetro como Create, o arquivo morto é aberto como FileMode.CreateNew o valor do modo de arquivo. Se o arquivo já existir, um IOException será gerado.

Quando você define o mode parâmetro como Update, o arquivo morto é aberto como FileMode.OpenOrCreate o valor do modo de arquivo. Se o arquivo existir, ele será aberto. As entradas existentes podem ser modificadas e novas entradas podem ser criadas. Se o arquivo morto não existir, um novo arquivo será criado; no entanto, a criação de um arquivo zip no Update modo não é tão eficiente quanto criá-lo no Create modo.

Quando você abre um arquivo zip archive para leitura e entryNameEncoding é definido como null, os nomes de entrada e os comentários são decodificados de acordo com as seguintes regras:

• Quando o sinalizador de codificação de idioma (no sinalizador de bits de uso geral do cabeçalho de arquivo local) não é definido, a página de código padrão do sistema atual é usada para decodificar o nome de entrada e o comentário.
• Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome e o comentário da entrada.

Quando você abre um arquivo zip archive para leitura e entryNameEncoding é definido como um valor diferente nullde , nomes de entrada e comentários são decodificados de acordo com as seguintes regras:

• Quando o sinalizador de codificação de idioma não é definido, o especificado entryNameEncoding é usado para decodificar o nome e o comentário da entrada.
• Quando o sinalizador de codificação de idioma é definido, UTF-8 é usado para decodificar o nome e o comentário da entrada.

Quando você grava em arquivos arquivados e entryNameEncoding é definido como null, os nomes de entrada e os comentários são codificados de acordo com as seguintes regras:

• Para nomes de entrada ou comentários que contêm caracteres fora do intervalo ASCII, o sinalizador de codificação de idioma é definido e os nomes de entrada e comentários são codificados usando UTF-8.
• Para nomes de entrada ou comentários que contêm apenas caracteres ASCII, o sinalizador de codificação de idioma não está definido e os nomes de entrada e comentários são codificados usando a página de código padrão do sistema atual.

Quando você grava em arquivos de arquivo morto e entryNameEncoding é definido como um valor diferente null, o especificado entryNameEncoding é usado para codificar os nomes de entrada e comentários em bytes. O sinalizador de codificação de idioma (no sinalizador de bits de uso geral do cabeçalho do arquivo local) é definido somente quando a codificação especificada é uma codificação UTF-8.