CompressionLevel 列挙型


圧縮操作で速度を重視するか、または圧縮サイズを重視するかを示す値を指定します。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


Fastest 1

圧縮後のファイルが最適な圧縮でなくても、圧縮操作はできるだけ迅速に完了する必要があります。The compression operation should complete as quickly as possible, even if the resulting file is not optimally compressed.

NoCompression 2

ファイルに対して圧縮を行いません。No compression should be performed on the file.

Optimal 0

圧縮操作が完了するまで時間がかかる場合でも、最適な圧縮を行います。The compression operation should be optimally compressed, even if the operation takes a longer time to complete.


通常、圧縮操作には、圧縮の速度と効果のトレードオフが伴います。Compression operations usually involve a tradeoff between the speed and the effectiveness of compression. この CompressionLevel 列挙体を使用して、開発シナリオでより重要な要素を示すことができます。これは、圧縮操作を完了するまでの時間または圧縮されたファイルのサイズです。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. これらの値は、特定の圧縮レベルに対応していません。圧縮を実装するオブジェクトは、その処理方法を決定します。These values do not correspond to specific compression levels; the object that implements compression determines how to handle them.

、、、、およびの各クラスの次のメソッドには、 DeflateStream GZipStream ZipArchive ZipFile ZipFileExtensions 圧縮レベルを指定できるという名前のパラメーターが含まれてい compressionLevel ます。The following methods of the DeflateStream, GZipStream, ZipArchive, ZipFile, and ZipFileExtensions classes include a parameter named compressionLevel that lets you specify the compression level:


次の例では、クラスを使用して zip アーカイブを作成するときに圧縮レベルを設定する方法を示し ZipFile ます。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\";

            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\"

        ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, True)
    End Sub

End Module