CompressionLevel Enumeration

Definition

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Gibt Werte an, die angeben, ob bei einem Komprimierungsvorgang die Geschwindigkeit oder die Komprimierungsgröße im Vordergrund steht.

public enum class CompressionLevel

public enum CompressionLevel

type CompressionLevel = 

Public Enum CompressionLevel

Vererbung

Object

ValueType

Enum

CompressionLevel

Felder

Fastest	1	Der Komprimierungsvorgang soll so schnell wie möglich beendet werden, auch wenn die resultierende Datei nicht optimal komprimiert wird.
NoCompression	2	Bei der Datei sollte keine Komprimierung erfolgen.
Optimal	0	Der Komprimierungsvorgang sollte die Komprimierungsgeschwindigkeit und die Ausgabegröße optimal ausgleichen.
SmallestSize	3	Der Komprimierungsvorgang sollte eine möglichst kleine Ausgabe erzeugen, auch wenn der Vorgang länger dauert.

Hinweise

Komprimierungsvorgänge beinhalten in der Regel einen Kompromiss zwischen der Geschwindigkeit und der Effektivität der Komprimierung. Sie verwenden die CompressionLevel -Enumeration, um anzugeben, welcher Faktor in Ihrem Entwicklungsszenario wichtiger ist: die Zeit zum Abschließen des Komprimierungsvorgangs oder die Größe der komprimierten Datei. Diese Werte entsprechen nicht bestimmten Komprimierungsstufen. Das -Objekt, das die Komprimierung implementiert, bestimmt, wie sie behandelt werden sollen.

Die folgenden Methoden der DeflateStreamKlassen , GZipStream, ZipArchive, ZipFileund ZipFileExtensions enthalten einen Parameter namens compressionLevel , mit dem Sie die Komprimierungsebene angeben können:

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Komprimierungsebene beim Erstellen eines ZIP-Archivs mithilfe der ZipFile -Klasse festgelegt wird.

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