CompressionLevel CompressionLevel CompressionLevel CompressionLevel Enum

Définition

Spécifie les valeurs qui indiquent si une opération de compression souligne la rapidité ou la taille de compression.Specifies values that indicate whether a compression operation emphasizes speed or compression size.

public enum class CompressionLevel
public enum CompressionLevel
type CompressionLevel = 
Public Enum CompressionLevel
Héritage
CompressionLevelCompressionLevelCompressionLevelCompressionLevel

Champs

Fastest Fastest Fastest 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.The compression operation should complete as quickly as possible, even if the resulting file is not optimally compressed.

NoCompression NoCompression NoCompression NoCompression 2

Aucune compression ne doit être exécutée sur le fichier.No compression should be performed on the file.

Optimal Optimal Optimal Optimal 0

L'opération de compression doit être compressée de manière optimale, même si elle prend plus de temps.The compression operation should be optimally compressed, even if the operation takes a longer time to complete.

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.The following example shows how to set the compression level when creating a zip archive by using the ZipFile class.

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

Remarques

Les opérations de compression impliquent généralement un compromis entre la vitesse et l’efficacité de la compression.Compression operations usually involve a tradeoff between the speed and the effectiveness of compression. Vous utilisez le CompressionLevel énumération pour indiquer quel facteur est plus importante dans votre scénario de développement : le temps nécessaire à l’opération de compression ou la taille du fichier compressé.You use the CompressionLevel enumeration to indicate which factor is more important in your development scenario: the time to complete the compression operation or the size of the compressed file. Ces valeurs ne correspondent pas à des niveaux de compression spécifique ; l’objet qui implémente la compression détermine comment les gérer.These values do not correspond to specific compression levels; the object that implements compression determines how to handle them.

Les méthodes suivantes de la DeflateStream, GZipStream, ZipArchive, ZipFile, et ZipFileExtensions classes incluent un paramètre nommé compressionLevel qui vous permet de spécifier le niveau de compression :The following methods of the DeflateStream, GZipStream, ZipArchive, ZipFile, and ZipFileExtensions classes include a parameter named compressionLevel that lets you specify the compression level:

S’applique à