diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml index f53e383ae04..ecb60f39935 100644 --- a/xml/System.IO.Compression/DeflateStream.xml +++ b/xml/System.IO.Compression/DeflateStream.xml @@ -64,6 +64,8 @@ The class uses the same compression a The compression functionality in and 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 and 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 can vary between .NET releases, platforms, and underlying compression engines. Changes in zlib versions, algorithm tweaks, and performance optimizations might 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 class to compress and decompress a file.