ZipArchive.CreateEntry Metodo

Definizione

Crea una voce vuota nell'archivio ZIP.Creates an empty entry in the zip archive.

Overload

CreateEntry(String)

Crea una voce vuota con il percorso e il nome della voce specificati nell'archivio ZIP.Creates an empty entry that has the specified path and entry name in the zip archive.

CreateEntry(String, CompressionLevel)

Crea una voce vuota con il livello di compressione e il nome voce specificati nell'archivio ZIP.Creates an empty entry that has the specified entry name and compression level in the zip archive.

CreateEntry(String)

Crea una voce vuota con il percorso e il nome della voce specificati nell'archivio 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

Parametri

entryName
String

Percorso, relativo alla radice dell'archivio, che specifica il nome della voce da creare.A path, relative to the root of the archive, that specifies the name of the entry to be created.

Restituisce

Voce vuota nell'archivio zip.An empty entry in the zip archive.

Eccezioni

entryName è Empty.entryName is Empty.

entryName è null.entryName is null.

L'archivio ZIP non supporta la scrittura.The zip archive does not support writing.

L'archivio ZIP è stato eliminato.The zip archive has been disposed.

Esempi

Nell'esempio seguente viene illustrato come creare una voce e scrivervi utilizzando un flusso.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

Commenti

La entryName stringa deve riflettere il percorso relativo della voce che si vuole creare nell'archivio zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Non esiste alcuna restrizione sulla stringa fornita.There is no restriction on the string you provide. Tuttavia, se non è formattato come percorso relativo, la voce viene creata, ma è possibile che venga generata un'eccezione quando si estrae il contenuto dell'archivio 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. Se nell'archivio esiste già una voce con il percorso e il nome specificati, viene creata una seconda voce con lo stesso nome e percorso.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.

Il valore della LastWriteTime proprietà per la nuova voce è impostato sull'ora corrente.The value of the LastWriteTime property for the new entry is set to the current time. La voce viene compressa utilizzando il livello di compressione predefinito dell'algoritmo di compressione sottostante.The entry is compressed using the default compression level of the underlying compression algorithm. Se si desidera specificare un livello di compressione diverso, utilizzare il CreateEntry metodo.If you want to specify a different compression level, use the CreateEntry method.

CreateEntry(String, CompressionLevel)

Crea una voce vuota con il livello di compressione e il nome voce specificati nell'archivio 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

Parametri

entryName
String

Percorso, relativo alla radice dell'archivio, che specifica il nome della voce da creare.A path, relative to the root of the archive, that specifies the name of the entry to be created.

compressionLevel
CompressionLevel

Uno dei valori di enumerazione che indica se evidenziare l'efficacia di velocità o compressione quando si crea la voce.One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.

Restituisce

Voce vuota nell'archivio zip.An empty entry in the zip archive.

Eccezioni

entryName è Empty.entryName is Empty.

entryName è null.entryName is null.

L'archivio ZIP non supporta la scrittura.The zip archive does not support writing.

L'archivio ZIP è stato eliminato.The zip archive has been disposed.

Esempi

Nell'esempio seguente viene illustrato come creare una voce con il livello di compressione ottimale.The following example shows how to create an entry with the optimal compression level. Scrive inoltre nella nuova voce utilizzando un flusso.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

Commenti

La entryName stringa deve riflettere il percorso relativo della voce che si vuole creare nell'archivio zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Non esiste alcuna restrizione sulla stringa fornita.There is no restriction on the string you provide. Tuttavia, se non è formattato come percorso relativo, la voce viene creata, ma è possibile che venga generata un'eccezione quando si estrae il contenuto dell'archivio 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. Se nell'archivio esiste già una voce con il nome specificato, viene creata una seconda voce con lo stesso nome.If an entry with the specified name already exists in the archive, a second entry is created with the same name.

Il valore della LastWriteTime proprietà per la nuova voce è impostato sull'ora corrente.The value of the LastWriteTime property for the new entry is set to the current time. Impostare il compressionLevel parametro su Optimal se si desidera che il file venga compresso il più possibile.Set the compressionLevel parameter to Optimal if you want the file to be compressed as much as possible. Impostare il compressionLevel parametro su Fastest solo se si desidera che l'operazione di compressione non venga completata abbastanza rapidamente per lo scenario.Set the compressionLevel parameter to Fastest only if you are concerned that the compression operation will not complete quickly enough for your scenario.

Si applica a