CompressionLevel Enumeración

Definición

Espacio de nombres:

System.IO.Compression

Ensamblado:

System.IO.Compression.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Especifica valores que indican si una operación de compresión resalta la velocidad o el tamaño de la compresión.

public enum class CompressionLevel

public enum CompressionLevel

type CompressionLevel = 

Public Enum CompressionLevel

Herencia

Object

ValueType

Enum

CompressionLevel

Campos

Fastest	1	La operación de compresión debe completarse lo antes posible, aunque el archivo resultante no esté comprimido de forma óptima.
NoCompression	2	No debe comprimirse el archivo.
Optimal	0	La operación de compresión debe equilibrar de forma óptima la velocidad de compresión y el tamaño de salida.
SmallestSize	3	La operación de compresión debe crear la salida lo más pequeña posible, incluso si la operación tarda más tiempo en completarse.

Comentarios

Las operaciones de compresión suelen implicar un equilibrio entre la velocidad y la eficacia de la compresión. Use la CompressionLevel enumeración para indicar qué factor es más importante en el escenario de desarrollo: el tiempo para completar la operación de compresión o el tamaño del archivo comprimido. Estos valores no corresponden a niveles de compresión específicos; el objeto que implementa la compresión determina cómo controlarlos.

Los métodos siguientes de las DeflateStreamclases , GZipStream, ZipArchive, ZipFiley ZipFileExtensions incluyen un parámetro denominado compressionLevel que permite especificar el nivel de compresión:

• DeflateStream.DeflateStream(Stream, CompressionLevel)

• DeflateStream.DeflateStream(Stream, CompressionLevel, Boolean)

• GZipStream.GZipStream(Stream, CompressionLevel)

• GZipStream.GZipStream(Stream, CompressionLevel, Boolean)

• ZipArchive.CreateEntry(String, CompressionLevel)

• ZipFile.CreateFromDirectory(String, String, CompressionLevel, Boolean)

• ZipFileExtensions.CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el nivel de compresión al crear un archivo ZIP mediante la ZipFile clase .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string startPath = @"c:\example\start";
            string zipPath = @"c:\example\result.zip";

            ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, true);
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = "c:\example\start"
        Dim zipPath As String = "c:\example\result.zip"

        ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, True)
    End Sub

End Module