CompressionLevel Enumeration
Definition
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 ein Komprimierungsvorgang die Geschwindigkeit oder Komprimierungsgröße betont.
public enum class CompressionLevelpublic enum CompressionLeveltype CompressionLevel = Public Enum CompressionLevel- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Optimal | 0 | Der Komprimierungsvorgang sollte die Komprimierungsgeschwindigkeit und die Ausgabegröße optimal ausgleichen. |
| Fastest | 1 | Der Komprimierungsvorgang sollte so schnell wie möglich abgeschlossen werden, auch wenn die resultierende Datei nicht optimal komprimiert ist. |
| NoCompression | 2 | Für die Datei sollte keine Komprimierung ausgeführt werden. |
| SmallestSize | 3 | Der Komprimierungsvorgang sollte die Ausgabe so klein wie möglich erstellen, auch wenn der Vorgang länger dauert, bis der Vorgang abgeschlossen ist. |
Hinweise
Komprimierungsvorgänge umfassen 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 der Größe der komprimierten Datei. Diese Werte entsprechen nicht bestimmten Komprimierungsebenen; das Objekt, das die Komprimierung implementiert, bestimmt, wie sie behandelt werden.
Die folgenden Methoden der DeflateStreamKlassen , , GZipStream, ZipArchiveund ZipFileZipFileExtensions der Klassen enthalten einen Parameter mit dem NamencompressionLevel, 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)
Examples
Das folgende Beispiel zeigt, 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
