ZipArchive.CreateEntry ZipArchive.CreateEntry ZipArchive.CreateEntry ZipArchive.CreateEntry Method

Définition

Crée une entrée vide dans l'archive zip.Creates an empty entry in the zip archive.

Surcharges

CreateEntry(String) CreateEntry(String) CreateEntry(String) CreateEntry(String)

Crée une entrée vide qui porte le chemin d'accès et le nom d'entrée spécifiés dans l'archive zip.Creates an empty entry that has the specified path and entry name in the zip archive.

CreateEntry(String, CompressionLevel) CreateEntry(String, CompressionLevel) CreateEntry(String, CompressionLevel)

Crée une entrée vide qui porte le nom d'entrée et le niveau de compression spécifiés dans l'archive zip.Creates an empty entry that has the specified entry name and compression level in the zip archive.

CreateEntry(String) CreateEntry(String) CreateEntry(String) CreateEntry(String)

Crée une entrée vide qui porte le chemin d'accès et le nom d'entrée spécifiés dans l'archive zip.Creates an empty entry that has the specified path and entry name in the zip archive.

public:
 System::IO::Compression::ZipArchiveEntry ^ CreateEntry(System::String ^ entryName);
public System.IO.Compression.ZipArchiveEntry CreateEntry (string entryName);
member this.CreateEntry : string -> System.IO.Compression.ZipArchiveEntry
Public Function CreateEntry (entryName As String) As ZipArchiveEntry

Paramètres

entryName
String String String String

Chemin d'accès, relatif à la racine de l'archive, qui spécifie le nom de l'entrée à créer.A path, relative to the root of the archive, that specifies the name of the entry to be created.

Retours

Entrée vide dans l'archive ZIP.An empty entry in the zip archive.

Exceptions

L’archive zip ne prend pas en charge l’écriture.The zip archive does not support writing.

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

Exemples

L’exemple suivant montre comment créer une entrée et y écrire à l’aide d’un flux.The following example shows how to create an entry and write to it by using a stream.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            using (FileStream zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open))
            {
                using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
                {
                    ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt");
                    using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                    {
                            writer.WriteLine("Information about this package.");
                            writer.WriteLine("========================");
                    }
                }
            }
        }
    }
}
Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Using zipToOpen As FileStream = New FileStream("c:\users\exampleuser\release.zip", FileMode.Open)
            Using archive As ZipArchive = New ZipArchive(zipToOpen, ZipArchiveMode.Update)
                Dim readmeEntry As ZipArchiveEntry = archive.CreateEntry("Readme.txt")
                Using writer As StreamWriter = New StreamWriter(readmeEntry.Open())
                    writer.WriteLine("Information about this package.")
                    writer.WriteLine("========================")
                End Using
            End Using
        End Using
    End Sub

End Module

Remarques

La entryName chaîne doit refléter le chemin d’accès relatif de l’entrée que vous souhaitez créer dans l’archive zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Il n’existe aucune restriction sur la chaîne que vous fournissez.There is no restriction on the string you provide. Toutefois, s’il n’est pas mis en forme en tant que chemin d’accès relatif, l’entrée est créée, mais vous pouvez obtenir une exception lorsque vous extrayez le contenu de l’archive zip.However, if it is not formatted as a relative path, the entry is created, but you may get an exception when you extract the contents of the zip archive. Si une entrée avec le chemin d’accès et le nom spécifiés existe déjà dans l’archive, une deuxième entrée est créée avec le même chemin d’accès et le même nom.If an entry with the specified path and name already exists in the archive, a second entry is created with the same path and name.

La valeur de la LastWriteTime propriété de la nouvelle entrée est définie sur l’heure actuelle.The value of the LastWriteTime property for the new entry is set to the current time. L’entrée est compressée à l’aide du niveau de compression par défaut de l’algorithme de compression sous-jacent.The entry is compressed using the default compression level of the underlying compression algorithm. Si vous souhaitez spécifier un niveau de compression différent, utilisez la CreateEntry méthode.If you want to specify a different compression level, use the CreateEntry method.

CreateEntry(String, CompressionLevel) CreateEntry(String, CompressionLevel) CreateEntry(String, CompressionLevel)

Crée une entrée vide qui porte le nom d'entrée et le niveau de compression spécifiés dans l'archive zip.Creates an empty entry that has the specified entry name and compression level in the zip archive.

public:
 System::IO::Compression::ZipArchiveEntry ^ CreateEntry(System::String ^ entryName, System::IO::Compression::CompressionLevel compressionLevel);
public System.IO.Compression.ZipArchiveEntry CreateEntry (string entryName, System.IO.Compression.CompressionLevel compressionLevel);
member this.CreateEntry : string * System.IO.Compression.CompressionLevel -> System.IO.Compression.ZipArchiveEntry

Paramètres

entryName
String String String String

Chemin d'accès, relatif à la racine de l'archive, qui spécifie le nom de l'entrée à créer.A path, relative to the root of the archive, that specifies the name of the entry to be created.

compressionLevel
CompressionLevel CompressionLevel CompressionLevel CompressionLevel

L'une des valeurs d'énumération qui indique s'il faut mettre l'accent sur rapidité ou la compression en créant l'entrée.One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.

Retours

Entrée vide dans l'archive ZIP.An empty entry in the zip archive.

Exceptions

L’archive zip ne prend pas en charge l’écriture.The zip archive does not support writing.

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

Exemples

L’exemple suivant montre comment créer une entrée avec le niveau de compression optimal.The following example shows how to create an entry with the optimal compression level. Il écrit également dans la nouvelle entrée à l’aide d’un flux.It also writes to the new entry by using a stream.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            using (FileStream zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open))
            {
                using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
                {
                    ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal);
                    using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                    {
                            writer.WriteLine("Information about this package.");
                            writer.WriteLine("========================");
                    }
                }
            }
        }
    }
}
Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Using zipToOpen As FileStream = New FileStream("c:\users\exampleuser\release.zip", FileMode.Open)
            Using archive As ZipArchive = New ZipArchive(zipToOpen, ZipArchiveMode.Update)
                Dim readmeEntry As ZipArchiveEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal)
                Using writer As StreamWriter = New StreamWriter(readmeEntry.Open())
                    writer.WriteLine("Information about this package.")
                    writer.WriteLine("========================")
                End Using
            End Using
        End Using
    End Sub

End Module

Remarques

La entryName chaîne doit refléter le chemin d’accès relatif de l’entrée que vous souhaitez créer dans l’archive zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Il n’existe aucune restriction sur la chaîne que vous fournissez.There is no restriction on the string you provide. Toutefois, s’il n’est pas mis en forme en tant que chemin d’accès relatif, l’entrée est créée, mais vous pouvez obtenir une exception lorsque vous extrayez le contenu de l’archive zip.However, if it is not formatted as a relative path, the entry is created, but you may get an exception when you extract the contents of the zip archive. Si une entrée portant le nom spécifié existe déjà dans l’archive, une deuxième entrée portant le même nom est créée.If an entry with the specified name already exists in the archive, a second entry is created with the same name.

La valeur de la LastWriteTime propriété de la nouvelle entrée est définie sur l’heure actuelle.The value of the LastWriteTime property for the new entry is set to the current time. Affectez compressionLevel au Optimal paramètre la valeur si vous souhaitez que le fichier soit compressé autant que possible.Set the compressionLevel parameter to Optimal if you want the file to be compressed as much as possible. Affectez compressionLevel au Fastest paramètre la valeur uniquement si vous craignez que l’opération de compression ne se termine pas suffisamment rapidement pour votre scénario.Set the compressionLevel parameter to Fastest only if you are concerned that the compression operation will not complete quickly enough for your scenario.

S’applique à