Language

ZipArchive.GetEntry(String) メソッド

定義

名前空間:
System.IO.Compression
アセンブリ:
System.IO.Compression.dll
アセンブリ:
netstandard.dll, System.IO.Compression.dll
アセンブリ:
netstandard.dll
ソース:
ZipArchive.cs
ソース:
ZipArchive.cs
ソース:
ZipArchive.cs
ソース:
ZipArchive.cs
ソース:
ZipArchive.cs

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 します。

例外

ArgumentException

entryName は Emptyです。

ArgumentNullException

entryName は nullです。

NotSupportedException

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

ObjectDisposedException

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

InvalidDataException

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

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

注釈

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

適用対象