DeflateStream Constructor (Stream^, CompressionLevel, Boolean)
Initializes a new instance of the DeflateStream class by using the specified stream and compression level, and optionally leaves the stream open.
Assembly: System (in System.dll)
public: DeflateStream( Stream^ stream, CompressionLevel compressionLevel, bool leaveOpen )
Parameters
- stream
-
Type:
System.IO::Stream^
The stream to compress.
- compressionLevel
-
Type:
System.IO.Compression::CompressionLevel
One of the enumeration values that indicates whether to emphasize speed or compression efficiency when compressing the stream.
- leaveOpen
-
Type:
System::Boolean
true to leave the stream object open after disposing the DeflateStream object; otherwise, false.
| Exception | Condition |
|---|---|
| ArgumentNullException | stream is null. |
| ArgumentException | The stream does not support write operations such as compression. (The CanWrite property on the stream object is false.) |
You use this constructor when you want to specify whether compression efficiency or speed is more important for an instance of the DeflateStream class, and whether to leave the stream object open after disposing the DeflateStream object.
This constructor overload uses the compression mode Compress. To set the compression mode to another value, use the DeflateStream(Stream^, CompressionMode) or DeflateStream(Stream^, CompressionMode, Boolean) overload.
The following example shows how to set the compression level when creating a DeflateStream object and how to leave the stream open.
Available since 8
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1