ZipArchive.GetEntry(String) Método

Definição

Recupera um wrapper para a entrada especificada no arquivo zip.

public System.IO.Compression.ZipArchiveEntry GetEntry (string entryName);
public System.IO.Compression.ZipArchiveEntry? GetEntry (string entryName);

Parâmetros

entryName
String

Um caminho, relativo à raiz do arquivo, que identifica a entrada a ser recuperada.

Retornos

Um wrapper para a entrada especificada no arquivo; null se a entrada não existir no arquivo morto.

Exceções

entryName é Empty.

entryName é null.

O arquivo zip não dá suporte à leitura.

O arquivo zip foi descartado.

O arquivo zip está corrompido e as entradas não podem ser recuperadas.

Exemplos

O exemplo a seguir mostra como usar o GetEntry método para recuperar uma entrada.

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

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\example\result.zip";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                ZipArchiveEntry entry = archive.GetEntry("ExistingFile.txt");
                using (StreamWriter writer = new StreamWriter(entry.Open()))
                {
                    writer.BaseStream.Seek(0, SeekOrigin.End);
                    writer.WriteLine("append line to file");
                }
                entry.LastWriteTime = DateTimeOffset.UtcNow.LocalDateTime;
            }
        }
    }
}

Comentários

Se houver várias entradas que tenham o nome especificado no arquivo morto, a primeira será retornada. O nome da entrada é comparado ao entryName uso de comparação ordinal.

Aplica-se a

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.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0