CompressionLevel Enumeration

Referenz

Definition

Namespace:: System.IO.Compression

Assembly:: System.IO.Compression.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Name	Wert	Beschreibung
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:

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

Gilt für:

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Teilen über