From 42d9c36679a263d8bcfff09dcdf40bd3ed45327d Mon Sep 17 00:00:00 2001 From: Petr Onderka Date: Thu, 29 Oct 2026 19:21:37 +0100 Subject: [PATCH 1/3] Document EXTOBS0003 HybridCache compression warning Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7acdfec6-bcbc-4332-a81f-de770b55241b --- .../syslib-diagnostics/extobs0003.md | 30 +++++++++++++++++++ .../obsoletions-overview.md | 1 + docs/navigate/tools-diagnostics/toc.yml | 2 ++ 3 files changed, 33 insertions(+) create mode 100644 docs/fundamentals/syslib-diagnostics/extobs0003.md diff --git a/docs/fundamentals/syslib-diagnostics/extobs0003.md b/docs/fundamentals/syslib-diagnostics/extobs0003.md new file mode 100644 index 0000000000000..f0887aacf4a2f --- /dev/null +++ b/docs/fundamentals/syslib-diagnostics/extobs0003.md @@ -0,0 +1,30 @@ +--- +title: EXTOBS0003 warning +description: Learn about the obsolete HybridCacheOptions.DisableCompression property that generates compile-time warning EXTOBS0003. +ms.date: 10/29/2026 +f1_keywords: + - extobs0003 +ai-usage: ai-generated +--- + +# EXTOBS0003: HybridCacheOptions.DisableCompression is obsolete + +The property is obsolete. Use of this property generates warning `EXTOBS0003` at compile time. + +The default `HybridCache` implementation doesn't provide built-in compression, so the property has no effect, regardless of its value. + +## Workarounds + +Remove references to `HybridCacheOptions.DisableCompression` from your code. For the default `HybridCache` implementation, you don't need a replacement setting because the property never enabled or disabled compression. + +To compress cached data, configure a serializer that performs compression. For information about custom serializers, see [HybridCache serialization](../../core/extensions/caching.md#serialization). + +The `HybridCacheEntryFlags.DisableCompression` flag isn't obsolete. The flag belongs to the shared abstraction, and other `HybridCache` implementations might honor it. + +## Suppress a warning + +If you can't remove references to the obsolete property, suppress `EXTOBS0003` with a `#pragma warning` directive in your source code or a `` property in your project file. For more information, see [Suppress warnings](obsoletions-overview.md#suppress-warnings). + +## See also + +- [HybridCache in .NET](../../core/extensions/caching.md#hybridcache) diff --git a/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md b/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md index 81476974d9421..60d704c2d1ff1 100644 --- a/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md +++ b/docs/fundamentals/syslib-diagnostics/obsoletions-overview.md @@ -100,6 +100,7 @@ The following table lists the `EXTOBS0XXX` obsoletions from the `Microsoft.Exten |---------------|------------------|-------------| | [EXTOBS0001](extobs0001.md) | Warning | is obsolete and will be removed in a future version. Consider using [Resource Monitoring observable instruments](../../core/diagnostics/built-in-metrics-diagnostics.md#microsoftextensionsdiagnosticsresourcemonitoring). | | [EXTOBS0002](extobs0002.md) | Warning | The `AddServiceLogEnricher` extension methods have been marked as obsolete starting in package version 10.1.0. The methods enrich application logs, not service logs, so they have been replaced with correctly named `AddApplicationLogEnricher` methods. | +| [EXTOBS0003](extobs0003.md) | Warning | is obsolete because the default `HybridCache` implementation doesn't provide built-in compression and the property has no effect. | ## Suppress warnings diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index a0535c61e96e2..e437198ac811a 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -4358,6 +4358,8 @@ items: href: ../../fundamentals/syslib-diagnostics/extobs0001.md - name: EXTOBS0002 href: ../../fundamentals/syslib-diagnostics/extobs0002.md + - name: EXTOBS0003 + href: ../../fundamentals/syslib-diagnostics/extobs0003.md - name: API compatibility items: - name: Overview From 8ebab4cd6bc1e6e9c42ca203add3f776d1c17822 Mon Sep 17 00:00:00 2001 From: Petr Onderka Date: Thu, 29 Oct 2026 19:25:04 +0100 Subject: [PATCH 2/3] Fix HybridCache overview section link Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7acdfec6-bcbc-4332-a81f-de770b55241b --- docs/fundamentals/syslib-diagnostics/extobs0003.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fundamentals/syslib-diagnostics/extobs0003.md b/docs/fundamentals/syslib-diagnostics/extobs0003.md index f0887aacf4a2f..b172d7f7067bf 100644 --- a/docs/fundamentals/syslib-diagnostics/extobs0003.md +++ b/docs/fundamentals/syslib-diagnostics/extobs0003.md @@ -27,4 +27,4 @@ If you can't remove references to the obsolete property, suppress `EXTOBS0003` w ## See also -- [HybridCache in .NET](../../core/extensions/caching.md#hybridcache) +- [HybridCache in .NET](../../core/extensions/caching.md#hybrid-caching) From 597a491f4c6ec43f3c78bf686f77a90b8dbb2fd6 Mon Sep 17 00:00:00 2001 From: Petr Onderka Date: Fri, 30 Oct 2026 11:58:35 +0100 Subject: [PATCH 3/3] Move and reword note about the DisableCompression flag Moved and clarified the status of HybridCacheEntryFlags.DisableCompression. --- docs/fundamentals/syslib-diagnostics/extobs0003.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fundamentals/syslib-diagnostics/extobs0003.md b/docs/fundamentals/syslib-diagnostics/extobs0003.md index b172d7f7067bf..bae2b4eccc2b4 100644 --- a/docs/fundamentals/syslib-diagnostics/extobs0003.md +++ b/docs/fundamentals/syslib-diagnostics/extobs0003.md @@ -13,14 +13,14 @@ The ` property in your project file. For more information, see [Suppress warnings](obsoletions-overview.md#suppress-warnings).