CompressionLevel Enumeration

Definition

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Assembly:

System.dll

Assembly:

netstandard.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 die Ausgabe so klein wie möglich erstellen, auch wenn der Vorgang länger dauert, bis er abgeschlossen ist.

Hinweise

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

Die folgenden Methoden der DeflateStream, , GZipStream, ZipArchiveZipFile, und ZipFileExtensions Klassen umfassen 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 Sie die Komprimierungsebene beim Erstellen eines Zip-Archivs mithilfe der ZipFile Klasse festlegen.

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