CompressionLevel Enumerazione

Definizione

Spazio dei nomi:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Specifica i valori che indicano se in un'operazione di compressione viene attribuita maggiore importanza alla velocità o alle dimensioni di compressione.

public enum class CompressionLevel

public enum CompressionLevel

type CompressionLevel = 

Public Enum CompressionLevel

Ereditarietà

Object

ValueType

Enum

CompressionLevel

Campi

Fastest	1	L'operazione di compressione deve essere completata il più rapidamente possibile, anche se il file risultante non è compresso in modo ottimale.
NoCompression	2	Non deve essere eseguita alcuna compressione del file.
Optimal	0	L'operazione di compressione deve bilanciare in modo ottimale la velocità di compressione e le dimensioni di output.
SmallestSize	3	L'operazione di compressione deve creare l'output il più piccolo possibile, anche se il completamento dell'operazione richiede più tempo.

Commenti

Le operazioni di compressione comportano in genere un compromesso tra la velocità e l'efficacia della compressione. L'enumerazione CompressionLevel viene usata per indicare quale fattore è più importante nello scenario di sviluppo: il tempo necessario per completare l'operazione di compressione o le dimensioni del file compresso. Questi valori non corrispondono a livelli di compressione specifici; l'oggetto che implementa la compressione determina come gestirli.

I metodi seguenti delle DeflateStreamclassi , GZipStream, ZipArchive, ZipFilee ZipFileExtensions includono un parametro denominato compressionLevel che consente di specificare il livello di compressione:

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

Esempio

Nell'esempio seguente viene illustrato come impostare il livello di compressione durante la creazione di un archivio ZIP usando la 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