ZipArchive.GetEntry(String) Metoda

Definice

Obor názvů:

System.IO.Compression

Sestavení:

System.IO.Compression.dll

Zdroj:

ZipArchive.cs

Načte obálku pro zadanou položku v archivu zip.

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

Parametry

entryName

String

Cesta vzhledem ke kořenovému adresáři archivu, která identifikuje položku, která se má načíst.

Návraty

ZipArchiveEntry

Obálka pro zadanou položku v archivu; null pokud položka v archivu neexistuje.

Výjimky

ArgumentException

entryName je Empty.

ArgumentNullException

entryName je null.

NotSupportedException

Archiv zip nepodporuje čtení.

ObjectDisposedException

Archiv zip byl odstraněn.

InvalidDataException

Archiv zip je poškozen a jeho položky nelze načíst.

Příklady

Následující příklad ukazuje, jak použít metodu GetEntry k načtení položky.

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

Poznámky

Pokud v archivu existuje více položek se zadaným názvem, vrátí se první z nich. Název položky se porovná s entryName použitím porovnání řad.