ZipArchive.GetEntry(String) Metodo

Definizione

Spazio dei nomi:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Origine:

ZipArchive.cs

Recupera un wrapper per la voce specificata nell'archivio 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

Parametri

entryName

String

Percorso, relativo alla radice dell'archivio, che identifica la voce da recuperare.

Restituisce

ZipArchiveEntry

Wrapper per la voce specificata nell'archivio; null se la voce non esiste nell'archivio.

Eccezioni

ArgumentException

entryName è Empty.

ArgumentNullException

entryName è null.

NotSupportedException

L'archivio ZIP non supporta la lettura.

ObjectDisposedException

L'archivio ZIP è stato eliminato.

InvalidDataException

L'archivio ZIP è danneggiato e le relative voci non possono essere recuperate.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il GetEntry metodo per recuperare una voce.

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

Commenti

Se nell'archivio esistono più voci con il nome specificato, viene restituito il primo. Il nome della voce viene confrontato con entryName l'utilizzo del confronto ordinale.