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

Definition

Erstellt einen leeren Eintrag im ZIP-Archiv.Creates an empty entry in the zip archive.

Überlädt

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

Erstellt einen leeren Eintrag, der den angegebenen Pfad und Eintragsnamen im ZIP-Archiv Ebene verwendet.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)

Erstellt einen leeren Eintrag, der den angegebenen Eintragsnamen und die Komprimierung im ZIP-Archiv Ebene verwendet.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)

Erstellt einen leeren Eintrag, der den angegebenen Pfad und Eintragsnamen im ZIP-Archiv Ebene verwendet.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

Parameter

entryName
String String String String

Ein Pfad relativ zum Stamm des Archivs, der den Namen des Eintrags angibt, der erstellt werden soll.A path, relative to the root of the archive, that specifies the name of the entry to be created.

Gibt zurück

Ein leerer Eintrag im ZIP-Archiv.An empty entry in the zip archive.

Ausnahmen

Das ZIP-Archiv unterstützt keine Schreibvorgänge.The zip archive does not support writing.

Die ZIP-Archiv wurde freigegeben.The zip archive has been disposed.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Eintrag erstellt und mithilfe eines Streams darauf geschrieben wird.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

Hinweise

Die entryName Zeichenfolge sollte den relativen Pfad des Eintrags widerspiegeln, den Sie im ZIP-Archiv erstellen möchten.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Es gibt keine Einschränkung für die von Ihnen bereitgestellte Zeichenfolge.There is no restriction on the string you provide. Wenn Sie jedoch nicht als relativer Pfad formatiert ist, wird der Eintrag erstellt, aber Sie erhalten möglicherweise eine Ausnahme, wenn Sie den Inhalt des ZIP-Archivs extrahieren.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. Wenn ein Eintrag mit dem angegebenen Pfad und Namen bereits im Archiv vorhanden ist, wird ein zweiter Eintrag mit demselben Pfad und Namen erstellt.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.

Der Wert der LastWriteTime -Eigenschaft für den neuen Eintrag wird auf die aktuelle Zeit festgelegt.The value of the LastWriteTime property for the new entry is set to the current time. Der Eintrag wird mit der Standard Komprimierungs Ebene des zugrunde liegenden Komprimierungs Algorithmus komprimiert.The entry is compressed using the default compression level of the underlying compression algorithm. Wenn Sie eine andere Komprimierungs Ebene angeben möchten, verwenden Sie CreateEntry die-Methode.If you want to specify a different compression level, use the CreateEntry method.

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

Erstellt einen leeren Eintrag, der den angegebenen Eintragsnamen und die Komprimierung im ZIP-Archiv Ebene verwendet.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

Parameter

entryName
String String String String

Ein Pfad relativ zum Stamm des Archivs, der den Namen des Eintrags angibt, der erstellt werden soll.A path, relative to the root of the archive, that specifies the name of the entry to be created.

compressionLevel
CompressionLevel CompressionLevel CompressionLevel CompressionLevel

Einer der Enumerationswerte, der angibt, ob Geschwindigkeit oder Komprimierungseffektivität priorisiert wird, wenn der Eintrag erstellt.One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.

Gibt zurück

Ein leerer Eintrag im ZIP-Archiv.An empty entry in the zip archive.

Ausnahmen

Das ZIP-Archiv unterstützt keine Schreibvorgänge.The zip archive does not support writing.

Die ZIP-Archiv wurde freigegeben.The zip archive has been disposed.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Eintrag mit der optimalen Komprimierungs Ebene erstellt wird.The following example shows how to create an entry with the optimal compression level. Außerdem wird mit einem Stream in den neuen Eintrag geschrieben.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

Hinweise

Die entryName Zeichenfolge sollte den relativen Pfad des Eintrags widerspiegeln, den Sie im ZIP-Archiv erstellen möchten.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Es gibt keine Einschränkung für die von Ihnen bereitgestellte Zeichenfolge.There is no restriction on the string you provide. Wenn Sie jedoch nicht als relativer Pfad formatiert ist, wird der Eintrag erstellt, aber Sie erhalten möglicherweise eine Ausnahme, wenn Sie den Inhalt des ZIP-Archivs extrahieren.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. Wenn im Archiv bereits ein Eintrag mit dem angegebenen Namen vorhanden ist, wird ein zweiter Eintrag mit demselben Namen erstellt.If an entry with the specified name already exists in the archive, a second entry is created with the same name.

Der Wert der LastWriteTime -Eigenschaft für den neuen Eintrag wird auf die aktuelle Zeit festgelegt.The value of the LastWriteTime property for the new entry is set to the current time. Legen Sie compressionLevel den- Optimal Parameter auf fest, wenn Sie die Datei so weit wie möglich komprimieren möchten.Set the compressionLevel parameter to Optimal if you want the file to be compressed as much as possible. Legen Sie compressionLevel den- Fastest Parameter auf fest, wenn Sie Bedenken haben, dass der Komprimierungs Vorgang für Ihr Szenario nicht schnell genug ausgeführt werden soll.Set the compressionLevel parameter to Fastest only if you are concerned that the compression operation will not complete quickly enough for your scenario.

Gilt für: