ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) Method

Definición

Recupera un contenedor para la entrada especificada en el archivo zip.Retrieves a wrapper for the specified entry in the zip archive.

public:
 System::IO::Compression::ZipArchiveEntry ^ GetEntry(System::String ^ entryName);
public System.IO.Compression.ZipArchiveEntry GetEntry (string entryName);
member this.GetEntry : string -> System.IO.Compression.ZipArchiveEntry
Public Function GetEntry (entryName As String) As ZipArchiveEntry

Parámetros

entryName
String String String String

Ruta de acceso, relativa a la raíz del archivo, que identifica la entrada a recuperar.A path, relative to the root of the archive, that identifies the entry to retrieve.

Devoluciones

Un contenedor para la entrada especificada en el archivo; null si la entrada no existe en el archivo.A wrapper for the specified entry in the archive; null if the entry does not exist in the archive.

Excepciones

El archivo zip no admite lectura.The zip archive does not support reading.

Se ha eliminado el archivo zip.The zip archive has been disposed.

El archivo zip está dañado y no se puede recuperar sus entradas.The zip archive is corrupt, and its entries cannot be retrieved.

Ejemplos

El ejemplo siguiente muestra cómo usar el GetEntry método para recuperar una entrada.The following example shows how to use the GetEntry method to retrieve an entry.

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;
            }
        }
    }
}
Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\example\result.zip"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            Dim entry As ZipArchiveEntry = archive.GetEntry("ExistingFile.txt")

            Using writer As StreamWriter = New StreamWriter(entry.Open())
                writer.BaseStream.Seek(0, SeekOrigin.End)
                writer.WriteLine("append line to file")
            End Using
            entry.LastWriteTime = DateTimeOffset.UtcNow.LocalDateTime
        End Using
    End Sub

End Module

Comentarios

Si varias entradas que tienen el nombre especificado existen en el archivo, se devuelve la primera de ellas.If multiple entries that have the specified name exist in the archive, the first one is returned. El nombre de la entrada se compara con entryName mediante la comparación ordinal.The name of the entry is compared to entryName using ordinal comparison.

Se aplica a