ZipArchive.GetEntry(String) Methode

Definition

Namespace:
System.IO.Compression
Assembly:
System.IO.Compression.dll
Assemblys:
netstandard.dll, System.IO.Compression.dll
Assembly:
netstandard.dll
Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs
Quelle:
ZipArchive.cs

Ruft einen Wrapper für den angegebenen Eintrag im ZIP-Archiv ab.

public:
 System::IO::Compression::ZipArchiveEntry ^ GetEntry(System::String ^ entryName);
public System.IO.Compression.ZipArchiveEntry GetEntry(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

Ein Pfad relativ zum Stammverzeichnis des Archivs, der den abzurufenden Eintrag identifiziert.

Gibt zurück

ZipArchiveEntry

Ein Wrapper für den angegebenen Eintrag im Archiv; null wenn der Eintrag nicht im Archiv vorhanden ist.

Ausnahmen

ArgumentException

entryName ist Empty.

ArgumentNullException

entryName ist null.

NotSupportedException

Das ZIP-Archiv unterstützt das Lesen nicht.

ObjectDisposedException

Das ZIP-Archiv wurde gelöscht.

InvalidDataException

Das ZIP-Archiv ist beschädigt, und die Einträge können nicht abgerufen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie die GetEntry Methode zum Abrufen eines Eintrags verwenden.

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

open System
open System.IO
open System.IO.Compression

[<EntryPoint>]
let main _ =
    let zipPath = @"c:\example\result.zip"

    use archive = ZipFile.Open(zipPath, ZipArchiveMode.Update)

    let entry = archive.GetEntry "ExistingFile.txt"
    use writer = new StreamWriter(entry.Open())

    writer.BaseStream.Seek(0, SeekOrigin.End) |> ignore
    writer.WriteLine "append line to file"

    entry.LastWriteTime <- DateTimeOffset.UtcNow.LocalDateTime
    0

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 zurückgegeben. Der Name des Eintrags wird mit entryName dem Vergleich von Ordinalvergleichen verglichen.

Gilt für: