Skip to content

Add explanation for DeflateStream byte differences #11762

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 4, 2025
Merged

Add explanation for DeflateStream byte differences #11762

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a7af2a6
add remark about different byte sequence
alinpahontu2912 Sep 3, 2025
cd51d88
commit suggeestion
alinpahontu2912 Sep 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions xml/System.IO.Compression/DeflateStream.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,8 @@ The <xref:System.IO.Compression.DeflateStream> class uses the same compression a

The compression functionality in <xref:System.IO.Compression.DeflateStream> and <xref:System.IO.Compression.GZipStream> is exposed as a stream. Data is read on a byte-by-byte basis, so it is not possible to perform multiple passes to determine the best method for compressing entire files or large blocks of data. The <xref:System.IO.Compression.DeflateStream> and <xref:System.IO.Compression.GZipStream> classes are best used on uncompressed sources of data. If the source data is already compressed, using these classes may actually increase the size of the stream.

The exact compressed byte sequence returned by <xref:System.IO.Compression.DeflateStream> can vary between .NET releases, platforms, or underlying compression engines, as changes in zlib versions, algorithm tweaks, or performance optimizations may produce different outputs for the same input data, but any data compressed by DeflateStream can always be decompressed to its original form without loss.

## Examples

The following example shows how to use the <xref:System.IO.Compression.DeflateStream> class to compress and decompress a file.
Expand Down