验证 BrotliStream 的 CompressionLevel

传递给 BrotliStream 构造函数的 CompressionLevel 参数现已验证是该枚举所定义的值之一。

旧行为

为 CompressionLevel 参数传递介于 0 和 11 之间的任何值都被视为有效。 该值将映射到枚举所定义的某个值，或者按原样传递到基础 Brotli 实现。

新行为

BrotliStream 构造函数的 CompressionLevel 参数的唯一有效值是：

• CompressionLevel.Optimal
• CompressionLevel.Fastest
• CompressionLevel.NoCompression
• CompressionLevel.SmallestSize

如果传递任何其他值，则在运行时会引发 ArgumentException。

引入的版本

.NET 7

中断性变更的类型

此项更改可能会影响二进制兼容性。

更改原因

能够传递 CompressionLevel 枚举未定义的任意值的操作不是预期操作，没有任何记载，并且该操作可能会导致错误。

建议的操作

如有必要，请更改代码以传递一个有效 CompressionLevel 值。

受影响的 API

• BrotliStream(Stream, CompressionLevel, Boolean)
• BrotliStream(Stream, CompressionLevel)