ZipFileExtensions.CreateEntryFromFile Método

Definición

Espacio de nombres:

System.IO.Compression

Ensamblado:

System.IO.Compression.ZipFile.dll

Archiva un archivo comprimiéndolo y agregándolo al archivo zip.

Sobrecargas

CreateEntryFromFile(ZipArchive, String, String)	Archiva un archivo comprimiéndolo y agregándolo al archivo zip.
CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)	Archiva un archivo comprimiéndolo mediante el nivel especificado de compresión y agregándolo al archivo zip.

CreateEntryFromFile(ZipArchive, String, String)

Source:

ZipFileExtensions.ZipArchive.Create.cs

Archiva un archivo comprimiéndolo y agregándolo al archivo zip.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName);

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName);

static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string -> System.IO.Compression.ZipArchiveEntry

<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String) As ZipArchiveEntry

Parámetros

destination

ZipArchive

Archivo .zip al que se agrega el archivo.

sourceFileName

String

Ruta de acceso al archivo que se va a archivar. Puede especificar una ruta de acceso relativa o absoluta. Una ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.

entryName

String

Nombre de la entrada que se va a crear en el archivo zip.

Devoluciones

ZipArchiveEntry

Un contenedor para la nueva entrada en el archivo zip.

Excepciones

ArgumentException

El valor de sourceFileName es Empty, contiene solo espacios en blanco o contiene al menos un carácter no válido.

o bien

entryName es Empty.

ArgumentNullException

sourceFileName o entryName es null.

PathTooLongException

En sourceFileName, la ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

sourceFileName no es válido (por ejemplo, está en una unidad no asignada).

IOException

El archivo especificado por sourceFileName no se puede abrir o es demasiado grande para actualizarse (el límite actual es Int32.MaxValue).

UnauthorizedAccessException

sourceFileName especifica un directorio.

O bien

El autor de la llamada no tiene el permiso necesario para obtener acceso al archivo que especifica sourceFileName.

FileNotFoundException

No se encuentra el archivo especificado por sourceFileName.

NotSupportedException

El parámetro sourceFileName tiene un formato que no es válido.

O bien

El archivo zip no admite escritura.

ObjectDisposedException

El archivo .zip se ha desechado.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una nueva entrada en un archivo ZIP a partir de un archivo existente.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Comentarios

La nueva entrada del archivo contiene el contenido del archivo especificado por sourceFileName. Si ya existe una entrada con el nombre especificado (entryName) en el archivo, se crea una segunda entrada con un nombre idéntico. La LastWriteTime propiedad de la entrada se establece en la última vez que se cambió el archivo en el sistema de archivos.

Cuando ZipArchiveMode.Update está presente, el límite de tamaño de una entrada se limita a Int32.MaxValue. Este límite se debe a que el modo de actualización usa internamente MemoryStream para permitir la búsqueda necesaria al actualizar un archivo y MemoryStream tiene un tamaño máximo igual al tamaño de un int.

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Source:

ZipFileExtensions.ZipArchive.Create.cs

Archiva un archivo comprimiéndolo mediante el nivel especificado de compresión y agregándolo al archivo zip.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName, System::IO::Compression::CompressionLevel compressionLevel);

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel);

static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel -> System.IO.Compression.ZipArchiveEntry

<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel) As ZipArchiveEntry

Parámetros

destination

ZipArchive

Archivo .zip al que se agrega el archivo.

sourceFileName

String

Ruta de acceso al archivo que se va a archivar. Puede especificar una ruta de acceso relativa o absoluta. Una ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.

entryName

String

Nombre de la entrada que se va a crear en el archivo zip.

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.

Devoluciones

ZipArchiveEntry

Un contenedor para la nueva entrada en el archivo zip.

Excepciones

ArgumentException

El valor de sourceFileName es Empty, contiene solo espacios en blanco o contiene al menos un carácter no válido.

o bien

entryName es Empty.

ArgumentNullException

sourceFileName o entryName es null.

DirectoryNotFoundException

sourceFileName no es válido (por ejemplo, está en una unidad no asignada).

PathTooLongException

En sourceFileName, la ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

IOException

El archivo especificado por sourceFileName no se puede abrir o es demasiado grande para actualizarse (el límite actual es Int32.MaxValue).

UnauthorizedAccessException

sourceFileName especifica un directorio.

O bien

El autor de la llamada no tiene el permiso necesario para obtener acceso al archivo que especifica sourceFileName.

FileNotFoundException

No se encuentra el archivo especificado por sourceFileName.

NotSupportedException

El parámetro sourceFileName tiene un formato que no es válido.

O bien

El archivo zip no admite escritura.

ObjectDisposedException

El archivo .zip se ha desechado.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una nueva entrada en un archivo ZIP a partir de un archivo existente y especificar el nivel de compresión.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest);
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Comentarios

La nueva entrada del archivo contiene el contenido del archivo especificado por sourceFileName. Si ya existe una entrada con el nombre especificado (entryName) en el archivo, se crea una segunda entrada con un nombre idéntico. La LastWriteTime propiedad de la entrada se establece en la última vez que se cambió el archivo en el sistema de archivos.

Cuando ZipArchiveMode.Update está presente, el límite de tamaño de una entrada se limita a Int32.MaxValue. Este límite se debe a que el modo de actualización usa internamente MemoryStream para permitir la búsqueda necesaria al actualizar un archivo y MemoryStream tiene un tamaño máximo igual al tamaño de un int.