/// <summary> /// Create a GZipStream using the specified CompressionMode and the specified CompressionLevel, /// and explicitly specify whether the stream should be left open after Deflation or Inflation. /// </summary> /// <remarks> /// <para> /// This constructor allows the application to request that the captive stream remain open after /// the deflation or inflation occurs. By default, after Close() is called on the stream, the /// captive stream is also closed. In some cases this is not desired, for example if the stream /// is a memory stream that will be re-read after compressed data has been written to it. Specify true for the /// leaveOpen parameter to leave the stream open. /// </para> /// <para> /// As noted in the class documentation, /// the CompressionMode (Compress or Decompress) also establishes the "direction" of the stream. /// A GZipStream with CompressionMode.Compress works only through Write(). A GZipStream with /// CompressionMode.Decompress works only through Read(). /// </para> /// </remarks> /// <example> /// This example shows how to use a DeflateStream to compress data. /// <code> /// using (System.IO.Stream input = System.IO.File.OpenRead(fileToCompress)) /// { /// using (var raw = System.IO.File.Create(outputFile)) /// { /// using (Stream compressor = new GZipStream(raw, CompressionMode.Compress, CompressionLevel.BEST_COMPRESSION, true)) /// { /// byte[] buffer = new byte[WORKING_BUFFER_SIZE]; /// int n= -1; /// while (n != 0) /// { /// if (n > 0) /// compressor.Write(buffer, 0, n); /// n= input.Read(buffer, 0, buffer.Length); /// } /// } /// } /// } /// </code> /// <code lang="VB"> /// Dim outputFile As String = (fileToCompress & ".compressed") /// Using input As Stream = File.OpenRead(fileToCompress) /// Using raw As FileStream = File.Create(outputFile) /// Using compressor As Stream = New GZipStream(raw, CompressionMode.Compress, CompressionLevel.BEST_COMPRESSION, True) /// Dim buffer As Byte() = New Byte(4096) {} /// Dim n As Integer = -1 /// Do While (n <> 0) /// If (n > 0) Then /// compressor.Write(buffer, 0, n) /// End If /// n = input.Read(buffer, 0, buffer.Length) /// Loop /// End Using /// End Using /// End Using /// </code> /// </example> /// <param name="stream">The stream which will be read or written.</param> /// <param name="mode">Indicates whether the GZipStream will compress or decompress.</param> /// <param name="leaveOpen">true if the application would like the stream to remain open after inflation/deflation.</param> /// <param name="level">A tuning knob to trade speed for effectiveness.</param> public GZipStream(System.IO.Stream stream, CompressionMode mode, CompressionLevel level, bool leaveOpen) { _baseStream = new ZlibBaseStream(stream, mode, level, ZlibStreamFlavor.GZIP, leaveOpen); }
/// <summary> /// Create a DeflateStream using the specified CompressionMode and the specified CompressionLevel, /// and explicitly specify whether /// the stream should be left open after Deflation or Inflation. /// </summary> /// <remarks> /// <para> /// This constructor allows the application to request that the captive stream remain open after /// the deflation or inflation occurs. By default, after Close() is called on the stream, the /// captive stream is also closed. In some cases this is not desired, for example if the stream /// is a memory stream that will be re-read after compression. Specify true for the /// leaveOpen parameter to leave the stream open. /// </para> /// </remarks> /// <example> /// This example shows how to use a DeflateStream to compress data. /// <code> /// using (System.IO.Stream input = System.IO.File.OpenRead(fileToCompress)) /// { /// using (var raw = System.IO.File.Create(outputFile)) /// { /// using (Stream compressor = new DeflateStream(raw, CompressionMode.Compress, CompressionLevel.BEST_COMPRESSION, true)) /// { /// byte[] buffer = new byte[WORKING_BUFFER_SIZE]; /// int n= -1; /// while (n != 0) /// { /// if (n > 0) /// compressor.Write(buffer, 0, n); /// n= input.Read(buffer, 0, buffer.Length); /// } /// } /// } /// } /// </code> /// <code lang="VB"> /// Dim outputFile As String = (fileToCompress & ".compressed") /// Using input As Stream = File.OpenRead(fileToCompress) /// Using raw As FileStream = File.Create(outputFile) /// Using compressor As Stream = New DeflateStream(raw, CompressionMode.Compress, CompressionLevel.BEST_COMPRESSION, True) /// Dim buffer As Byte() = New Byte(4096) {} /// Dim n As Integer = -1 /// Do While (n <> 0) /// If (n > 0) Then /// compressor.Write(buffer, 0, n) /// End If /// n = input.Read(buffer, 0, buffer.Length) /// Loop /// End Using /// End Using /// End Using /// </code> /// </example> /// <param name="stream">The stream which will be read or written.</param> /// <param name="mode">Indicates whether the DeflateStream will compress or decompress.</param> /// <param name="leaveOpen">true if the application would like the stream to remain open after inflation/deflation.</param> /// <param name="level">A tuning knob to trade speed for effectiveness.</param> public DeflateStream(System.IO.Stream stream, CompressionMode mode, CompressionLevel level, bool leaveOpen) { _baseStream = new ZlibBaseStream(stream, mode, level, ZlibStreamFlavor.DEFLATE, leaveOpen); }