CompressionLevel Enumeração

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

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

Object

ValueType

Enum

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:

• 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)

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