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

Definición

Crea una entrada vacía en el archivo zip.Creates an empty entry in the zip archive.

Sobrecargas

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

Crea una entrada vacía en el archivo zip con la ruta de acceso y el nombre de entrada especificados.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)

Crea una entrada vacía en el archivo zip con el nombre de entrada y el nivel de compresión especificados.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)

Crea una entrada vacía en el archivo zip con la ruta de acceso y el nombre de entrada especificados.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

Parámetros

entryName
String String String String

Ruta de acceso, relativa a la raíz del archivo, que especifica el nombre de la entrada que se va a crear.A path, relative to the root of the archive, that specifies the name of the entry to be created.

Devoluciones

Una entrada vacía en el archivo zip.An empty entry in the zip archive.

Excepciones

El archivo zip no admite escritura.The zip archive does not support writing.

El archivo .zip se ha desechado.The zip archive has been disposed.

Ejemplos

El ejemplo siguiente muestra cómo crear una entrada y escribir en él mediante el uso de una secuencia.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

Comentarios

El entryName cadena debe reflejar la ruta de acceso relativa de la entrada que desee crear en el archivo zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. No hay ninguna restricción en la cadena proporcionada.There is no restriction on the string you provide. Sin embargo, si no tiene el formato como una ruta de acceso relativa, se crea la entrada, pero puede obtener una excepción cuando se extrae el contenido del archivo 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 ya existe una entrada con el nombre y ruta de acceso especificada en el archivo, se crea una segunda entrada con el mismo nombre y ruta de acceso.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.

El valor de la LastWriteTime se establece la propiedad de la nueva entrada a la hora actual.The value of the LastWriteTime property for the new entry is set to the current time. La entrada se comprime utilizando el nivel de compresión predeterminada del algoritmo de compresión subyacente.The entry is compressed using the default compression level of the underlying compression algorithm. Si desea especificar un nivel de compresión diferentes, utilice el CreateEntry método.If you want to specify a different compression level, use the CreateEntry method.

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

Crea una entrada vacía en el archivo zip con el nombre de entrada y el nivel de compresión especificados.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

Parámetros

entryName
String String String String

Ruta de acceso, relativa a la raíz del archivo, que especifica el nombre de la entrada que se va a crear.A path, relative to the root of the archive, that specifies the name of the entry to be created.

compressionLevel
CompressionLevel CompressionLevel CompressionLevel CompressionLevel

Uno de los valores de enumeración que indica si se va a hacer hincapié en la eficacia de velocidad o de compresión al crear la entrada.One of the enumeration values that indicates whether to emphasize speed or compression effectiveness when creating the entry.

Devoluciones

Una entrada vacía en el archivo zip.An empty entry in the zip archive.

Excepciones

El archivo zip no admite escritura.The zip archive does not support writing.

El archivo .zip se ha desechado.The zip archive has been disposed.

Ejemplos

El ejemplo siguiente muestra cómo crear una entrada con el nivel de compresión óptima.The following example shows how to create an entry with the optimal compression level. También escribe en la nueva entrada mediante el uso de una secuencia.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

Comentarios

El entryName cadena debe reflejar la ruta de acceso relativa de la entrada que desee crear en el archivo zip.The entryName string should reflect the relative path of the entry you want to create within the zip archive. No hay ninguna restricción en la cadena proporcionada.There is no restriction on the string you provide. Sin embargo, si no tiene el formato como una ruta de acceso relativa, se crea la entrada, pero puede obtener una excepción cuando se extrae el contenido del archivo 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 ya existe una entrada con el nombre especificado en el archivo, se crea una segunda entrada con el mismo nombre.If an entry with the specified name already exists in the archive, a second entry is created with the same name.

El valor de la LastWriteTime se establece la propiedad de la nueva entrada a la hora actual.The value of the LastWriteTime property for the new entry is set to the current time. Establecer el compressionLevel parámetro Optimal si desea que el archivo que se va a comprimir tanto como sea posible.Set the compressionLevel parameter to Optimal if you want the file to be compressed as much as possible. Establecer el compressionLevel parámetro Fastest solo si le preocupa que la operación de compresión no se completará con la rapidez suficiente para su escenario.Set the compressionLevel parameter to Fastest only if you are concerned that the compression operation will not complete quickly enough for your scenario.

Se aplica a