CompressionLevel Enumerazione

Definizione

Spazio dei nomi:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Assembly:

System.dll

Assembly:

netstandard.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 più piccolo possibile, anche se l'operazione richiede più tempo per completare.

Commenti

Le operazioni di compressione in genere comportano un compromesso tra la velocità e l'efficacia della compressione. Si usa l'enumerazione per indicare quale fattore è più importante nello scenario di sviluppo: il tempo per completare l'operazione CompressionLevel 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 classi , , ZipArchiveGZipStreamZipFile, e ZipFileExtensions includono un parametro denominato compressionLevel che consente di specificare il livello di DeflateStreamcompressione:

• 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