ZipFileExtensions.CreateEntryFromFile Método

Definição

Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.

Sobrecargas

CreateEntryFromFile(ZipArchive, String, String)

Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip.

CreateEntryFromFile(ZipArchive, String, String)

Origem:
ZipFileExtensions.ZipArchive.Create.cs
Origem:
ZipFileExtensions.ZipArchive.Create.cs
Origem:
ZipFileExtensions.ZipArchive.Create.cs

Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName);

Parâmetros

destination
ZipArchive

O arquivo zip ao qual o arquivo será adicionado.

sourceFileName
String

O caminho para o arquivo a ser arquivado. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

entryName
String

O nome da entrada a ser criada no arquivo zip.

Retornos

Um wrapper para a nova entrada no arquivo zip.

Exceções

sourceFileName é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.

- ou -

entryName é Empty.

sourceFileName ou entryName é null.

Em sourceFileName, o caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

sourceFileName é inválido (por exemplo, está em uma unidade não mapeada).

O arquivo especificado por sourceFileName não pode ser aberto ou é muito grande para ser atualizado (o limite atual é Int32.MaxValue).

sourceFileName especifica um diretório.

- ou -

O chamador não tem a permissão necessária para acessar o arquivo especificado por sourceFileName.

O arquivo especificado por sourceFileName não foi encontrado.

O parâmetro sourceFileName está em um formato inválido.

- ou -

O arquivo zip não dá suporte à gravação.

O arquivo zip foi descartado.

Exemplos

O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente.

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);
            }
        }
    }
}

Comentários

A nova entrada no arquivo contém o conteúdo do arquivo especificado por sourceFileName. Se uma entrada com o nome especificado (entryName) já existir no arquivo morto, uma segunda entrada será criada com um nome idêntico. A LastWriteTime propriedade da entrada é definida como a última vez que o arquivo no sistema de arquivos foi alterado.

Quando ZipArchiveMode.Update estiver presente, o limite de tamanho de uma entrada será limitado a Int32.MaxValue. Esse limite ocorre porque o modo de atualização usa um MemoryStream internamente para permitir a busca necessária ao atualizar um arquivo morto e MemoryStream tem um máximo igual ao tamanho de um int.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Origem:
ZipFileExtensions.ZipArchive.Create.cs
Origem:
ZipFileExtensions.ZipArchive.Create.cs
Origem:
ZipFileExtensions.ZipArchive.Create.cs

Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip.

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel);

Parâmetros

destination
ZipArchive

O arquivo zip ao qual o arquivo será adicionado.

sourceFileName
String

O caminho para o arquivo a ser arquivado. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

entryName
String

O nome da entrada a ser criada no arquivo zip.

compressionLevel
CompressionLevel

Um dos valores de enumeração que indica se é necessário enfatizar a eficiência de compactação ou velocidade ao criar a entrada.

Retornos

Um wrapper para a nova entrada no arquivo zip.

Exceções

sourceFileName é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.

- ou -

entryName é Empty.

sourceFileName ou entryName é null.

sourceFileName é inválido (por exemplo, está em uma unidade não mapeada).

Em sourceFileName, o caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

O arquivo especificado por sourceFileName não pode ser aberto ou é muito grande para ser atualizado (o limite atual é Int32.MaxValue).

sourceFileName especifica um diretório.

- ou -

O chamador não tem a permissão necessária para acessar o arquivo especificado por sourceFileName.

O arquivo especificado por sourceFileName não foi encontrado.

O parâmetro sourceFileName está em um formato inválido.

- ou -

O arquivo zip não dá suporte à gravação.

O arquivo zip foi descartado.

Exemplos

O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente e especificar o nível de compactação.

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", CompressionLevel.Fastest);
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Comentários

A nova entrada no arquivo contém o conteúdo do arquivo especificado por sourceFileName. Se uma entrada com o nome especificado (entryName) já existir no arquivo morto, uma segunda entrada será criada com um nome idêntico. A LastWriteTime propriedade da entrada é definida como a última vez que o arquivo no sistema de arquivos foi alterado.

Quando ZipArchiveMode.Update estiver presente, o limite de tamanho de uma entrada será limitado a Int32.MaxValue. Esse limite ocorre porque o modo de atualização usa um MemoryStream internamente para permitir a busca necessária ao atualizar um arquivo morto e MemoryStream tem um máximo igual ao tamanho de um int.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0