ZipArchive.CreateEntry Método

Definición

Espacio de nombres:

System.IO.Compression

Ensamblados:

netstandard.dll, System.IO.Compression.dll

Crea una entrada vacía en el archivo ZIP.

Sobrecargas

Nombre	Description
CreateEntry(String)	Crea una entrada vacía que tiene la ruta de acceso y el nombre de entrada especificados en el archivo ZIP.
CreateEntry(String, CompressionLevel)	Crea una entrada vacía que tiene el nombre de entrada y el nivel de compresión especificados en el archivo ZIP.

CreateEntry(String)

Source:

ZipArchive.cs

Crea una entrada vacía que tiene la ruta de acceso y el nombre de entrada especificados en el archivo ZIP.

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

Ruta de acceso, relativa a la raíz del archivo, que especifica el nombre de la entrada que se va a crear.

Devoluciones

ZipArchiveEntry

Entrada vacía en el archivo zip.

Excepciones

ArgumentException

entryName es Empty.

ArgumentNullException

entryName es null.

NotSupportedException

El archivo zip no admite la escritura.

ObjectDisposedException

Se ha eliminado el archivo ZIP.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una entrada y escribir en ella mediante una secuencia.

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("========================");
                    }
                }
            }
        }
    }
}

open System.IO
open System.IO.Compression

do
    use zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open)

    use archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update)

    let readmeEntry = archive.CreateEntry "Readme.txt"
    use 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

La entryName cadena debe reflejar la ruta de acceso relativa de la entrada que desea crear dentro del archivo ZIP. No hay ninguna restricción en la cadena que proporcione. Sin embargo, si no tiene formato de ruta de acceso relativa, se crea la entrada, pero puede obtener una excepción al extraer el contenido del archivo ZIP. Si ya existe una entrada con la ruta de acceso y el nombre especificados en el archivo, se crea una segunda entrada con la misma ruta de acceso y nombre.

El valor de la LastWriteTime propiedad de la nueva entrada se establece en la hora actual. La entrada se comprime mediante el nivel de compresión predeterminado del algoritmo de compresión subyacente. Si desea especificar un nivel de compresión diferente, use el CreateEntry método .

CreateEntry(String, CompressionLevel)

Source:

ZipArchive.cs

Crea una entrada vacía que tiene el nombre de entrada y el nivel de compresión especificados en el archivo ZIP.

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

Public Function CreateEntry (entryName As String, compressionLevel As CompressionLevel) As ZipArchiveEntry

Parámetros

entryName

String

Ruta de acceso, relativa a la raíz del archivo, que especifica el nombre de la entrada que se va a crear.

compressionLevel

CompressionLevel

Uno de los valores de enumeración que indica si se debe resaltar la velocidad o la eficacia de compresión al crear la entrada.

Devoluciones

ZipArchiveEntry

Entrada vacía en el archivo zip.

Excepciones

ArgumentException

entryName es Empty.

ArgumentNullException

entryName es null.

NotSupportedException

El archivo zip no admite la escritura.

ObjectDisposedException

Se ha eliminado el archivo ZIP.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una entrada con el nivel de compresión óptimo. También escribe en la nueva entrada mediante una secuencia.

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("========================");
                    }
                }
            }
        }
    }
}

open System.IO
open System.IO.Compression

do
    use zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open)

    use archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update)

    let readmeEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal)
    use 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

La entryName cadena debe reflejar la ruta de acceso relativa de la entrada que desea crear dentro del archivo ZIP. No hay ninguna restricción en la cadena que proporcione. Sin embargo, si no tiene formato de ruta de acceso relativa, se crea la entrada, pero puede obtener una excepción al extraer el contenido del archivo ZIP. Si ya existe una entrada con el nombre especificado en el archivo, se crea una segunda entrada con el mismo nombre.

El valor de la LastWriteTime propiedad de la nueva entrada se establece en la hora actual. Establezca el compressionLevel parámetro Optimal en si desea que el archivo se comprima tanto como sea posible. Establezca el compressionLevel parámetro Fastest en solo si le preocupa que la operación de compresión no se complete lo suficientemente rápido para su escenario.