ZipArchive.GetEntry(String) Metode

Definisi

Ruang nama:

System.IO.Compression

Rakitan:

System.IO.Compression.dll

Sumber:

ZipArchive.cs

Mengambil pembungkus untuk entri yang ditentukan dalam arsip 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

Parameter

entryName

String

Jalur, relatif terhadap akar arsip, yang mengidentifikasi entri untuk diambil.

Mengembalikan

ZipArchiveEntry

Pembungkus untuk entri yang ditentukan dalam arsip; null jika entri tidak ada di arsip.

Pengecualian

ArgumentException

entryNameadalah Empty.

ArgumentNullException

entryNameadalah null.

NotSupportedException

Arsip zip tidak mendukung pembacaan.

ObjectDisposedException

Arsip zip telah dibuang.

InvalidDataException

Arsip zip rusak, dan entrinya tidak dapat diambil.

Contoh

Contoh berikut menunjukkan cara menggunakan GetEntry metode untuk mengambil entri.

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

Keterangan

Jika beberapa entri yang memiliki nama yang ditentukan ada di arsip, entri pertama akan dikembalikan. Nama entri dibandingkan dengan menggunakan perbandingan entryName ordinal.