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

Definice

Vytvoří prázdný záznam v archívu zip.Creates an empty entry in the zip archive.

Přetížení

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

Vytvoří prázdný záznam, který má zadaný název cesty a položky v archívu 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)

Vytvoří prázdný záznam, který má úroveň název a provádí kompresi, zadaná položka v archívu 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)

Vytvoří prázdný záznam, který má zadaný název cesty a položky v archívu 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

Parametry

entryName
String String String String

Cesta, kořeni archiv, který určuje název položky, který se má vytvořit.A path, relative to the root of the archive, that specifies the name of the entry to be created.

Návraty

Prázdná položka v archívu zip.An empty entry in the zip archive.

Výjimky

Archiv zip nepodporuje zápis.The zip archive does not support writing.

Archiv zip byl uvolněn.The zip archive has been disposed.

Příklady

Následující příklad ukazuje, jak vytvořit položku a do ní zapisovat pomocí datového proudu.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

Poznámky

entryName Řetězec by měl odrážet relativní cesta položky, kterou chcete vytvořit v rámci archiv zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Neexistuje žádné omezení na řetězec, který zadáte.There is no restriction on the string you provide. Pokud není naformátován jako relativní cesta, je vytvořena, ale při extrahování obsahu archivu zip, může se zobrazit výjimka.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. Pokud položka se zadanou cestou a názvem již v archivu existuje, se vytvoří druhou položku se stejnou cestou a názvem.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.

Hodnota LastWriteTime nové položky je nastavena na aktuální čas.The value of the LastWriteTime property for the new entry is set to the current time. Položka je komprimován pomocí výchozí úroveň komprese podkladové kompresní algoritmus.The entry is compressed using the default compression level of the underlying compression algorithm. Pokud chcete určit úroveň různých komprese, použijte CreateEntry metody.If you want to specify a different compression level, use the CreateEntry method.

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

Vytvoří prázdný záznam, který má úroveň název a provádí kompresi, zadaná položka v archívu 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

Parametry

entryName
String String String String

Cesta, kořeni archiv, který určuje název položky, který se má vytvořit.A path, relative to the root of the archive, that specifies the name of the entry to be created.

compressionLevel
CompressionLevel CompressionLevel CompressionLevel CompressionLevel

Jedna z hodnot výčtu, která udává, jestli se má zvýraznit rychlost nebo komprese efektivitu při vytváření položky.One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.

Návraty

Prázdná položka v archívu zip.An empty entry in the zip archive.

Výjimky

Archiv zip nepodporuje zápis.The zip archive does not support writing.

Archiv zip byl uvolněn.The zip archive has been disposed.

Příklady

Následující příklad ukazuje, jak vytvořit položku s požadovanou úrovní aktualizace optimální komprese.The following example shows how to create an entry with the optimal compression level. Také zapíše do nové položky pomocí datového proudu.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

Poznámky

entryName Řetězec by měl odrážet relativní cesta položky, kterou chcete vytvořit v rámci archiv zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. Neexistuje žádné omezení na řetězec, který zadáte.There is no restriction on the string you provide. Pokud není naformátován jako relativní cesta, je vytvořena, ale při extrahování obsahu archivu zip, může se zobrazit výjimka.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. Pokud položka se zadaným názvem již v archivu existuje, vytvoří se druhá položka se stejným názvem.If an entry with the specified name already exists in the archive, a second entry is created with the same name.

Hodnota LastWriteTime nové položky je nastavena na aktuální čas.The value of the LastWriteTime property for the new entry is set to the current time. Nastavte compressionLevel parametr Optimal Pokud chcete soubor ke komprimaci co největší míře.Set the compressionLevel parameter to Optimal if you want the file to be compressed as much as possible. Nastavte compressionLevel parametr Fastest pouze v případě, že máte obavy, nebudou pro váš scénář dostatečně rychle dokončit operaci komprese.Set the compressionLevel parameter to Fastest only if you are concerned that the compression operation will not complete quickly enough for your scenario.

Platí pro