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

Definition

Ruft einen Wrapper für den angegebenen Eintrag im Zip-Archiv ab.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

Parameter

entryName
String String String String

Ein Pfad relativ zum Stamm des Archivs, das den Eintrag identifiziert, der abgerufen werden soll.A path, relative to the root of the archive, that identifies the entry to retrieve.

Gibt zurück

Ein Wrapper für den angegebenen Eintrag im Archiv. null, wenn der Eintrag nicht im Archiv vorhanden ist.A wrapper for the specified entry in the archive; null if the entry does not exist in the archive.

Ausnahmen

Das Zip-Archiv unterstützt keine Lesevorgänge.The zip archive does not support reading.

Die ZIP-Archiv wurde freigegeben.The zip archive has been disposed.

Das Zip-Archiv ist beschädigt, und seine Einträge konnten nicht abgerufen werden.The zip archive is corrupt, and its entries cannot be retrieved.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die GetEntry -Methode zum Abrufen eines-Eintrags verwendet wird.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

Hinweise

Wenn mehrere Einträge mit dem angegebenen Namen im Archiv vorhanden sind, wird der erste Wert zurückgegeben.If multiple entries that have the specified name exist in the archive, the first one is returned. Der Name des Eintrags wird entryName mithilfe eines Ordinalvergleichs verglichen.The name of the entry is compared to entryName using ordinal comparison.

Gilt für: