ZipArchive.GetEntry(String) メソッド

定義

zip アーカイブ内の指定したエントリのラッパーを取得します。

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

パラメーター

entryName
String

取得するエントリを識別する、アーカイブのルートを基準とするパス。

戻り値

ZipArchiveEntry

アーカイブ内の指定されたエントリのラッパー。エントリがアーカイブに存在しない場合は null

例外

entryNameEmptyです。

entryNamenullです。

zip アーカイブは読み取りをサポートしません。

zip アーカイブが破棄されました。

zip アーカイブが破損しているため、エントリを取得できません。

次の例は、 メソッドを使用 GetEntry してエントリを取得する方法を示しています。

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

注釈

指定した名前の複数のエントリがアーカイブに存在する場合は、最初のエントリが返されます。 エントリの名前は、序数比較を entryName 使用して比較されます。

適用対象