ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) ZipArchive.GetEntry(String) Method

Définition

Récupère un wrapper pour l'entrée spécifiée dans l'archive Zip.Retrieves a wrapper for the specified entry in the zip archive.

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

Paramètres

entryName
String String String String

Chemin d'accès, relatif à la racine de l'archive, qui identifie l'entrée à récupérer.A path, relative to the root of the archive, that identifies the entry to retrieve.

Retours

Wrapper pour l’entrée spécifiée dans l’archive ; null si l’entrée n’existe pas dans l’archive.A wrapper for the specified entry in the archive; null if the entry does not exist in the archive.

Exceptions

L’archive ZIP ne prend pas en charge la lecture.The zip archive does not support reading.

L’archive zip de a été supprimée.The zip archive has been disposed.

L’archive ZIP est endommagée et ses entrées ne peuvent pas être récupérées.The zip archive is corrupt, and its entries cannot be retrieved.

Exemples

L’exemple suivant montre comment utiliser la GetEntry méthode pour récupérer une entrée.The following example shows how to use the GetEntry method to retrieve an entry.

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

Remarques

Si plusieurs entrées portant le nom spécifié existent dans l’archive, la première est retournée.If multiple entries that have the specified name exist in the archive, the first one is returned. Le nom de l’entrée est comparé à entryName l’utilisation de la comparaison ordinale.The name of the entry is compared to entryName using ordinal comparison.

S’applique à