CompressionLevel Énumération

Définition

Espace de noms:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Spécifie des valeurs qui indiquent si une opération de compression privilégie la vitesse ou la taille de la compression.

public enum class CompressionLevel

public enum CompressionLevel

type CompressionLevel = 

Public Enum CompressionLevel

Héritage

Object

ValueType

Enum

CompressionLevel

Champs

Fastest	1	L'opération de compression doit s'exécuter aussi rapidement que possible, même si le fichier résultant n'est pas compressé de manière optimale.
NoCompression	2	Aucune compression ne doit être exécutée sur le fichier.
Optimal	0	L’opération de compression doit équilibrer de manière optimale la vitesse de compression et la taille de sortie.
SmallestSize	3	L’opération de compression doit créer une sortie aussi petite que possible, même si l’opération prend plus de temps.

Remarques

Les opérations de compression impliquent généralement un compromis entre la vitesse et l’efficacité de la compression. Vous utilisez l’énumération CompressionLevel pour indiquer quel facteur est plus important dans votre scénario de développement : temps pour terminer l’opération de compression ou la taille du fichier compressé. Ces valeurs ne correspondent pas à des niveaux de compression spécifiques ; l’objet qui implémente la compression détermine comment les gérer.

Les méthodes suivantes du DeflateStream, , ZipArchive, GZipStreamZipFileet ZipFileExtensions les classes incluent un paramètre nommé compressionLevel qui vous permet de spécifier le niveau de compression :

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

Exemples

L’exemple suivant montre comment définir le niveau de compression lors de la création d’une archive zip à l’aide de 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