Freigeben über

GZipStream Konstruktoren

  • Referenz

Definition

Namespace:
System.IO.Compression
Assembly:
System.IO.Compression.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Initialisiert eine neue Instanz der GZipStream Klasse.

Überlädt

GZipStream(Stream, CompressionLevel)

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom- und Komprimierungsebene.
GZipStream(Stream, CompressionMode)

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe des angegebenen Datenstrom- und Komprimierungsmodus.
GZipStream(Stream, CompressionLevel, Boolean)

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom- und Komprimierungsebene und lässt optional den Datenstrom geöffnet.
GZipStream(Stream, CompressionMode, Boolean)

Initialisiert eine neue Instanz der GZipStream-Klasse mithilfe des angegebenen Datenstrom- und Komprimierungsmodus und lässt optional den Datenstrom geöffnet.
GZipStream(Stream, ZLibCompressionOptions, Boolean)

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom-, Komprimierungsoptionen und lässt optional den Datenstrom geöffnet.

GZipStream(Stream, CompressionLevel)

Quelle:
GZipStream.cs
Quelle:
GZipStream.cs
Quelle:
GZipStream.cs

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom- und Komprimierungsebene.

public:
 GZipStream(System::IO::Stream ^ stream, System::IO::Compression::CompressionLevel compressionLevel);
public GZipStream (System.IO.Stream stream, System.IO.Compression.CompressionLevel compressionLevel);
new System.IO.Compression.GZipStream : System.IO.Stream * System.IO.Compression.CompressionLevel -> System.IO.Compression.GZipStream
Public Sub New (stream As Stream, compressionLevel As CompressionLevel)

Parameter

stream
Stream

Der Datenstrom, in den komprimierte Daten geschrieben werden.

compressionLevel
CompressionLevel

Einer der Enumerationswerte, der angibt, ob geschwindigkeits- oder komprimierungseffizienz beim Komprimieren von Daten in den Datenstrom hervorgehoben werden soll.

Ausnahmen

ArgumentNullException

stream ist null.

ArgumentException

Der Datenstrom unterstützt keine Schreibvorgänge wie Komprimierung. (Die CanWrite-Eigenschaft des Datenstromobjekts ist false.)

Hinweise

Sie verwenden diesen Konstruktor, wenn Sie angeben möchten, ob die Komprimierungseffizienz oder -geschwindigkeit für eine Instanz der GZipStream Klasse wichtiger ist.

Diese Konstruktorüberladung verwendet den Komprimierungsmodus Compress. Um den Komprimierungsmodus auf einen anderen Wert festzulegen, verwenden Sie die GZipStream(Stream, CompressionMode) oder GZipStream(Stream, CompressionMode, Boolean) Überladung.

Gilt für:

GZipStream(Stream, CompressionMode)

Quelle:
GZipStream.cs
Quelle:
GZipStream.cs
Quelle:
GZipStream.cs

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe des angegebenen Datenstrom- und Komprimierungsmodus.

public:
 GZipStream(System::IO::Stream ^ stream, System::IO::Compression::CompressionMode mode);
public GZipStream (System.IO.Stream stream, System.IO.Compression.CompressionMode mode);
new System.IO.Compression.GZipStream : System.IO.Stream * System.IO.Compression.CompressionMode -> System.IO.Compression.GZipStream
Public Sub New (stream As Stream, mode As CompressionMode)

Parameter

stream
Stream

Der Datenstrom, in den komprimierte Daten geschrieben werden oder aus dem Daten zum Dekomprimieren gelesen werden.

mode
CompressionMode

Einer der Enumerationswerte, der angibt, ob Daten in den Datenstrom komprimiert oder daten aus dem Datenstrom dekomprimieren sollen.

Ausnahmen

ArgumentNullException

stream ist null.

ArgumentException

mode ist kein gültiger CompressionMode Enumerationswert.

-oder-

CompressionMode ist Compress und CanWrite ist false.

-oder-

CompressionMode ist Decompress und CanRead ist false.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Komprimierungsmodus beim Erstellen eines GZipStream-Objekts festlegen.

using System;
using System.IO;
using System.IO.Compression;

public class FileCompressionModeExample
{
    private const string Message = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.";
    private const string OriginalFileName = "original.txt";
    private const string CompressedFileName = "compressed.gz";
    private const string DecompressedFileName = "decompressed.txt";

    public static void Run()
    {
        CreateFileToCompress();
        CompressFile();
        DecompressFile();
        PrintResults();
        DeleteFiles();

        /*
         Output:

            The original file 'original.txt' is 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

            The compressed file 'compressed.gz' is 283 bytes.

            The decompressed file 'decompressed.txt' is 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
         */
    }

    private static void CreateFileToCompress() => File.WriteAllText(OriginalFileName, Message);

    private static void CompressFile()
    {
        using FileStream originalFileStream = File.Open(OriginalFileName, FileMode.Open);
        using FileStream compressedFileStream = File.Create(CompressedFileName);
        using var compressor = new GZipStream(compressedFileStream, CompressionMode.Compress);
        originalFileStream.CopyTo(compressor);
    }

    private static void DecompressFile()
    {
        using FileStream compressedFileStream = File.Open(CompressedFileName, FileMode.Open);
        using FileStream outputFileStream = File.Create(DecompressedFileName);
        using var decompressor = new GZipStream(compressedFileStream, CompressionMode.Decompress);
        decompressor.CopyTo(outputFileStream);
    }

    private static void PrintResults()
    {
        long originalSize = new FileInfo(OriginalFileName).Length;
        long compressedSize = new FileInfo(CompressedFileName).Length;
        long decompressedSize = new FileInfo(DecompressedFileName).Length;

        Console.WriteLine($"The original file '{OriginalFileName}' is {originalSize} bytes. Contents: \"{File.ReadAllText(OriginalFileName)}\"");
        Console.WriteLine($"The compressed file '{CompressedFileName}' is {compressedSize} bytes.");
        Console.WriteLine($"The decompressed file '{DecompressedFileName}' is {decompressedSize} bytes. Contents: \"{File.ReadAllText(DecompressedFileName)}\"");
    }

    private static void DeleteFiles()
    {
        File.Delete(OriginalFileName);
        File.Delete(CompressedFileName);
        File.Delete(DecompressedFileName);
    }
}

open System.IO
open System.IO.Compression

let message =
    "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

let OriginalFileName = "original.txt"
let CompressedFileName = "compressed.gz"
let DecompressedFileName = "decompressed.txt"

let createFileToCompress () =
    File.WriteAllText(OriginalFileName, message)

let compressFile () =
    use originalFileStream = File.Open(OriginalFileName, FileMode.Open)
    use compressedFileStream = File.Create CompressedFileName
    use compressor = new GZipStream(compressedFileStream, CompressionMode.Compress)
    originalFileStream.CopyTo compressor

let decompressFile () =
    use compressedFileStream = File.Open(CompressedFileName, FileMode.Open)
    use outputFileStream = File.Create DecompressedFileName
    use decompressor = new GZipStream(compressedFileStream, CompressionMode.Decompress)
    decompressor.CopyTo outputFileStream

let printResults () =
    let originalSize = FileInfo(OriginalFileName).Length
    let compressedSize = FileInfo(CompressedFileName).Length
    let decompressedSize = FileInfo(DecompressedFileName).Length

    printfn
        $"The original file '{OriginalFileName}' weighs {originalSize} bytes. Contents: \"{File.ReadAllText OriginalFileName}\""

    printfn $"The compressed file '{CompressedFileName}' weighs {compressedSize} bytes."

    printfn
        $"The decompressed file '{DecompressedFileName}' weighs {decompressedSize} bytes. Contents: \"{File.ReadAllText DecompressedFileName}\""

let deleteFiles () =
    File.Delete OriginalFileName
    File.Delete CompressedFileName
    File.Delete DecompressedFileName

createFileToCompress ()
compressFile ()
decompressFile ()
printResults ()
deleteFiles ()

// Output:
//     The original file 'original.txt' weighs 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
//
//     The compressed file 'compressed.gz' weighs 283 bytes.
//
//     The decompressed file 'decompressed.txt' weighs 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

Imports System
Imports System.IO
Imports System.IO.Compression

Public Class FileCompressionModeExample
    Private Const Message As String = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
    Private Const OriginalFileName As String = "original.txt"
    Private Const CompressedFileName As String = "compressed.gz"
    Private Const DecompressedFileName As String = "decompressed.txt"

    Public Shared Sub Main()
        CreateFileToCompress()
        CompressFile()
        DecompressFile()
        PrintResults()
        DeleteFiles()

        ' Output:
        '   The original file 'original.txt' weighs 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

        '   The compressed file 'compressed.gz' weighs 283 bytes.

        '   The decompressed file 'decompressed.txt' weighs 445 bytes. Contents: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
    End Sub

    Private Shared Sub CreateFileToCompress()
        File.WriteAllText(OriginalFileName, Message)
    End Sub

    Private Shared Sub CompressFile()
        Using originalFileStream As FileStream = File.Open(OriginalFileName, FileMode.Open)
            Using compressedFileStream As FileStream = File.Create(CompressedFileName)
                Using compressor = New GZipStream(compressedFileStream, CompressionMode.Compress)
                    originalFileStream.CopyTo(compressor)
                End Using
            End Using
        End Using
    End Sub

    Private Shared Sub DecompressFile()
        Using compressedFileStream As FileStream = File.Open(CompressedFileName, FileMode.Open)
            Using outputFileStream As FileStream = File.Create(DecompressedFileName)
                Using decompressor = New GZipStream(compressedFileStream, CompressionMode.Decompress)
                    decompressor.CopyTo(outputFileStream)
                End Using
            End Using
        End Using
    End Sub

    Private Shared Sub PrintResults()
        Dim originalSize As Long = New FileInfo(OriginalFileName).Length
        Dim compressedSize As Long = New FileInfo(CompressedFileName).Length
        Dim decompressedSize As Long = New FileInfo(DecompressedFileName).Length

        Console.WriteLine($"The original file '{OriginalFileName}' weighs {originalSize} bytes. Contents: ""{File.ReadAllText(OriginalFileName)}""")
        Console.WriteLine($"The compressed file '{CompressedFileName}' weighs {compressedSize} bytes.")
        Console.WriteLine($"The decompressed file '{DecompressedFileName}' weighs {decompressedSize} bytes. Contents: ""{File.ReadAllText(DecompressedFileName)}""")
    End Sub

    Private Shared Sub DeleteFiles()
        File.Delete(OriginalFileName)
        File.Delete(CompressedFileName)
        File.Delete(DecompressedFileName)
    End Sub
End Class

Hinweise

Standardmäßig besitzt GZipStream den zugrunde liegenden Datenstrom, sodass das Schließen des stream Parameters auch den zugrunde liegenden Datenstrom schließt. Beachten Sie, dass sich der Zustand des zugrunde liegenden Datenstroms auf die Nutzbarkeit des Datenstroms auswirken kann. Außerdem werden keine expliziten Überprüfungen ausgeführt, sodass beim Erstellen der neuen Instanz keine zusätzlichen Ausnahmen ausgelöst werden.

Wenn eine Instanz der GZipStream-Klasse mit dem parameter mode gleich Compress erstellt wird und keine weitere Aktion ausgeführt wird, wird der Datenstrom als gültige, leere komprimierte Datei angezeigt.

Standardmäßig wird die Komprimierungsebene auf Optimal festgelegt, wenn der Komprimierungsmodus Compressist.

Gilt für:

GZipStream(Stream, CompressionLevel, Boolean)

Quelle:
GZipStream.cs
Quelle:
GZipStream.cs
Quelle:
GZipStream.cs

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom- und Komprimierungsebene und lässt optional den Datenstrom geöffnet.

public:
 GZipStream(System::IO::Stream ^ stream, System::IO::Compression::CompressionLevel compressionLevel, bool leaveOpen);
public GZipStream (System.IO.Stream stream, System.IO.Compression.CompressionLevel compressionLevel, bool leaveOpen);
new System.IO.Compression.GZipStream : System.IO.Stream * System.IO.Compression.CompressionLevel * bool -> System.IO.Compression.GZipStream
Public Sub New (stream As Stream, compressionLevel As CompressionLevel, leaveOpen As Boolean)

Parameter

stream
Stream

Der Datenstrom, in den komprimierte Daten geschrieben werden.

compressionLevel
CompressionLevel

Einer der Enumerationswerte, der angibt, ob geschwindigkeits- oder komprimierungseffizienz beim Komprimieren von Daten in den Datenstrom hervorgehoben werden soll.

leaveOpen
Boolean

true, das Datenstromobjekt nach dem Entfernen des GZipStream Objekts geöffnet zu lassen; andernfalls false.

Ausnahmen

ArgumentNullException

stream ist null.

ArgumentException

Der Datenstrom unterstützt keine Schreibvorgänge wie Komprimierung. (Die CanWrite-Eigenschaft des Datenstromobjekts ist false.)

Beispiele

Das folgende Beispiel zeigt, wie sie beim Erstellen eines GZipStream Objekts die Komprimierungsebene festlegen und wie der Datenstrom geöffnet bleiben soll.

using System;
using System.IO;
using System.IO.Compression;
using System.Text;

public static class MemoryWriteReadExample
{
    private const string Message = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.";
    private static readonly byte[] s_messageBytes = Encoding.ASCII.GetBytes(Message);

    public static void Run()
    {
        Console.WriteLine($"The original string length is {s_messageBytes.Length} bytes.");
        using var stream = new MemoryStream();
        CompressBytesToStream(stream);
        Console.WriteLine($"The compressed stream length is {stream.Length} bytes.");
        int decompressedLength = DecompressStreamToBytes(stream);
        Console.WriteLine($"The decompressed string length is {decompressedLength} bytes, same as the original length.");
        /*
         Output:
            The original string length is 445 bytes.
            The compressed stream length is 282 bytes.
            The decompressed string length is 445 bytes, same as the original length.
        */
    }

    private static void CompressBytesToStream(Stream stream)
    {
        using var compressor = new GZipStream(stream, CompressionLevel.SmallestSize, leaveOpen: true);
        compressor.Write(s_messageBytes, 0, s_messageBytes.Length);
    }

    private static int DecompressStreamToBytes(Stream stream)
    {
        stream.Position = 0;
        int bufferSize = 512;
        byte[] buffer = new byte[bufferSize];
        using var gzipStream = new GZipStream(stream, CompressionMode.Decompress);

        int totalRead = 0;
        while (totalRead < buffer.Length)
        {
            int bytesRead = gzipStream.Read(buffer.AsSpan(totalRead));
            if (bytesRead == 0) break;
            totalRead += bytesRead;
        }

        return totalRead;
    }
}

open System.IO
open System.IO.Compression
open System.Text

let message =
    "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

let s_messageBytes = Encoding.ASCII.GetBytes message

let compressBytesToStream stream =
    use compressor =
        new GZipStream(stream, CompressionLevel.SmallestSize, leaveOpen = true)

    compressor.Write(s_messageBytes, 0, s_messageBytes.Length)

let decompressStreamToBytes (stream: Stream) =
    stream.Position <- 0
    let bufferSize = 512
    let decompressedBytes = Array.zeroCreate bufferSize
    use decompressor = new GZipStream(stream, CompressionMode.Decompress)
    decompressor.Read(decompressedBytes, 0, bufferSize)

[<EntryPoint>]
let main _ =
    printfn $"The original string length is {s_messageBytes.Length} bytes."
    use stream = new MemoryStream()
    compressBytesToStream stream
    printfn $"The compressed stream length is {stream.Length} bytes."
    let decompressedLength = decompressStreamToBytes stream
    printfn $"The decompressed string length is {decompressedLength} bytes, same as the original length."
    0

// Output:
//     The original string length is 445 bytes.
//     The compressed stream length is 282 bytes.
//     The decompressed string length is 445 bytes, same as the original length.

Imports System.IO
Imports System.IO.Compression
Imports System.Text

Module MemoryWriteReadExample
    Private Const Message As String = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
    Private ReadOnly s_messageBytes As Byte() = Encoding.ASCII.GetBytes(Message)

    Sub Main()
        Console.WriteLine($"The original string length is {s_messageBytes.Length} bytes.")

        Using stream = New MemoryStream()
            CompressBytesToStream(stream)
            Console.WriteLine($"The compressed stream length is {stream.Length} bytes.")
            Dim decompressedLength As Integer = DecompressStreamToBytes(stream)
            Console.WriteLine($"The decompressed string length is {decompressedLength} bytes, same as the original length.")
        End Using
        ' Output:
        '   The original string length is 445 bytes.
        '   The compressed stream length is 282 bytes.
        '   The decompressed string length is 445 bytes, same as the original length.
    End Sub

    Private Sub CompressBytesToStream(ByVal stream As Stream)
        Using compressor = New GZipStream(stream, CompressionLevel.SmallestSize, leaveOpen:=True)
            compressor.Write(s_messageBytes, 0, s_messageBytes.Length)
        End Using
    End Sub

    Private Function DecompressStreamToBytes(ByVal stream As Stream) As Integer
        stream.Position = 0
        Dim bufferSize As Integer = 512
        Dim decompressedBytes As Byte() = New Byte(bufferSize - 1) {}
        Using decompressor = New GZipStream(stream, CompressionMode.Decompress)
            Dim length As Integer = decompressor.Read(decompressedBytes, 0, bufferSize)
            Return length
        End Using
    End Function
End Module

Hinweise

Sie verwenden diesen Konstruktor, wenn Sie angeben möchten, ob die Komprimierungseffizienz oder -geschwindigkeit für eine Instanz der GZipStream-Klasse wichtiger ist und ob das Datenstromobjekt geöffnet bleiben soll, nachdem das GZipStream-Objekt entfernt wurde.

Diese Konstruktorüberladung verwendet den Komprimierungsmodus Compress. Um den Komprimierungsmodus auf einen anderen Wert festzulegen, verwenden Sie die GZipStream(Stream, CompressionMode) oder GZipStream(Stream, CompressionMode, Boolean) Überladung.

Gilt für:

GZipStream(Stream, CompressionMode, Boolean)

Quelle:
GZipStream.cs
Quelle:
GZipStream.cs
Quelle:
GZipStream.cs

Initialisiert eine neue Instanz der GZipStream-Klasse mithilfe des angegebenen Datenstrom- und Komprimierungsmodus und lässt optional den Datenstrom geöffnet.

public:
 GZipStream(System::IO::Stream ^ stream, System::IO::Compression::CompressionMode mode, bool leaveOpen);
public GZipStream (System.IO.Stream stream, System.IO.Compression.CompressionMode mode, bool leaveOpen);
new System.IO.Compression.GZipStream : System.IO.Stream * System.IO.Compression.CompressionMode * bool -> System.IO.Compression.GZipStream
Public Sub New (stream As Stream, mode As CompressionMode, leaveOpen As Boolean)

Parameter

stream
Stream

Der Datenstrom, in den komprimierte Daten geschrieben werden oder aus dem Daten zum Dekomprimieren gelesen werden.

mode
CompressionMode

Einer der Enumerationswerte, der angibt, ob Daten in den Datenstrom komprimiert oder daten aus dem Datenstrom dekomprimieren sollen.

leaveOpen
Boolean

true, den Datenstrom nach dem Entfernen des GZipStream Objekts offen zu lassen; andernfalls false.

Ausnahmen

ArgumentNullException

stream ist null.

ArgumentException

mode ist kein gültiger CompressionMode Wert.

-oder-

CompressionMode ist Compress und CanWrite ist false.

-oder-

CompressionMode ist Decompress und CanRead ist false.

Hinweise

Standardmäßig besitzt GZipStream den zugrunde liegenden Datenstrom, sodass das Schließen des stream Parameters auch den zugrunde liegenden Datenstrom schließt. Der Zustand des zugrunde liegenden Datenstroms kann sich auf die Nutzbarkeit des Datenstroms auswirken. Außerdem werden keine expliziten Überprüfungen ausgeführt, sodass beim Erstellen der neuen Instanz keine zusätzlichen Ausnahmen ausgelöst werden.

Wenn eine Instanz der GZipStream-Klasse mit dem parameter mode gleich Compress erstellt wird und keine weitere Aktion ausgeführt wird, wird der Datenstrom als gültige, leere komprimierte Datei angezeigt.

Standardmäßig wird die Komprimierungsebene auf Optimal festgelegt, wenn der Komprimierungsmodus Compressist.

Gilt für:

GZipStream(Stream, ZLibCompressionOptions, Boolean)

Initialisiert eine neue Instanz der GZipStream Klasse mithilfe der angegebenen Datenstrom-, Komprimierungsoptionen und lässt optional den Datenstrom geöffnet.

public GZipStream (System.IO.Stream stream, System.IO.Compression.ZLibCompressionOptions compressionOptions, bool leaveOpen = false);
new System.IO.Compression.GZipStream : System.IO.Stream * System.IO.Compression.ZLibCompressionOptions * bool -> System.IO.Compression.GZipStream
Public Sub New (stream As Stream, compressionOptions As ZLibCompressionOptions, Optional leaveOpen As Boolean = false)

Parameter

stream
Stream

Der Datenstrom, in den komprimierte Daten geschrieben werden.

compressionOptions
ZLibCompressionOptions

Die Optionen zum Optimieren des Komprimierungsdatenstroms.

leaveOpen
Boolean

true, das Datenstromobjekt nach dem Entfernen des GZipStream Objekts geöffnet zu lassen; andernfalls false.

Ausnahmen

ArgumentNullException

stream oder compressionOptions ist null.

Gilt für: