Partilhar via


CompressionLevel Enumeração

Definição

Especifica valores que indicam se uma operação de compactação enfatiza a velocidade ou tamanho da compactação.

public enum class CompressionLevel
public enum CompressionLevel
type CompressionLevel = 
Public Enum CompressionLevel
Herança
CompressionLevel

Campos

Fastest 1

A operação de compactação deve ser concluída assim que possível, mesmo se o arquivo resultante não for compactado de forma ideal.

NoCompression 2

Nenhuma compactação deve ser executada no arquivo.

Optimal 0

A operação de compactação deve equilibrar de maneira ideal a velocidade de compactação e o tamanho da saída.

SmallestSize 3

A operação de compactação deve criar uma saída o menor possível, mesmo se a operação demorar mais tempo para ser concluída.

Comentários

As operações de compactação geralmente envolvem uma compensação entre a velocidade e a eficácia da compactação. Use a CompressionLevel enumeração para indicar qual fator é mais importante em seu cenário de desenvolvimento: o tempo para concluir a operação de compactação ou o tamanho do arquivo compactado. Esses valores não correspondem a níveis de compactação específicos; o objeto que implementa a compactação determina como tratá-los.

Os seguintes métodos das DeflateStreamclasses , GZipStream, ZipArchive, ZipFilee ZipFileExtensions incluem um parâmetro chamado compressionLevel que permite especificar o nível de compactação:

Exemplos

O exemplo a seguir mostra como definir o nível de compactação ao criar um arquivo zip usando a ZipFile classe .

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

Aplica-se a