ZipArchive.GetEntry(String) Méthode

Référence

Définition

Espace de noms:: System.IO.Compression

Assembly:: System.IO.Compression.dll

Assembly:: netstandard.dll

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Source:: ZipArchive.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Récupère un wrapper pour l'entrée spécifiée dans l'archive 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

Paramètres

entryName: String

Chemin d'accès, relatif à la racine de l'archive, qui identifie l'entrée à récupérer.

Retours

ZipArchiveEntry

Wrapper pour l’entrée spécifiée dans l’archive ; null si l’entrée n’existe pas dans l’archive.

Exceptions

ArgumentException

entryName a la valeur Empty.

ArgumentNullException

entryName a la valeur null.

NotSupportedException

L’archive ZIP ne prend pas en charge la lecture.

ObjectDisposedException

L’archive zip a été supprimée.

InvalidDataException

L’archive ZIP est endommagée et ses entrées ne peuvent pas être récupérées.

Exemples

L’exemple suivant montre comment utiliser la GetEntry méthode pour récupérer une entrée.

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

Remarques

Si plusieurs entrées qui ont le nom spécifié existent dans l’archive, la première est retournée. Le nom de l’entrée est comparé à l’aide de entryName la comparaison ordinale.

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Partager via