From f957f567632245af9083bae28df8f96604a701be Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 5 Aug 2026 17:11:58 +0000 Subject: [PATCH 1/3] Initial plan From 1336ea111739ed818967f1b8e81d04e32f9e26ac Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 5 Aug 2026 17:15:45 +0000 Subject: [PATCH 2/3] Document reload token behavior after load failures Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com> --- docs/core/compatibility/11.md | 1 + ...ationprovider-reload-token-load-failure.md | 41 +++++++++++++++++++ docs/core/compatibility/toc.yml | 2 + 3 files changed, 44 insertions(+) create mode 100644 docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md diff --git a/docs/core/compatibility/11.md b/docs/core/compatibility/11.md index 51b5589505918..4ee279fab9669 100644 --- a/docs/core/compatibility/11.md +++ b/docs/core/compatibility/11.md @@ -60,6 +60,7 @@ See [Breaking changes in EF Core 11](/ef/core/what-is-new/ef-core-11.0/breaking- | Title | Type of change | |-------|-------------------| | [ChangeToken.OnChange async overloads rebind existing Task-returning callbacks](extensions/11/changetoken-onchange-async-overloads-rebind-callbacks.md) | Behavioral change | +| [FileConfigurationProvider doesn't raise reload token after ignored load failure](extensions/11/fileconfigurationprovider-reload-token-load-failure.md) | Behavioral change | | [IHost.RunAsync and IHost.StopAsync throw when a BackgroundService fails](extensions/11/ihost-runasync-stopasync-throw-backgroundservice-failure.md) | Behavioral change | | [Some Microsoft.Extensions packages included in shared framework](extensions/11/extensions-in-shared-framework.md) | Behavioral change | diff --git a/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md b/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md new file mode 100644 index 0000000000000..157e192a19ae2 --- /dev/null +++ b/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md @@ -0,0 +1,41 @@ +--- +title: "Breaking change: FileConfigurationProvider doesn't raise reload token after ignored load failure" +description: "Learn about the breaking change in .NET 11 where FileConfigurationProvider doesn't raise its reload token after an ignored load failure." +ms.date: 08/05/2026 +ai-usage: ai-assisted +--- + +# FileConfigurationProvider doesn't raise reload token after ignored load failure + +In .NET 11, doesn't call `OnReload` or fire its reload token after fails and its callback ignores the exception. + +## Version introduced + +.NET 11 Preview 7 + +## Previous behavior + +Previously, after `Load` failed and the `OnLoadException` callback set to `true`, called `OnReload`. The reload token returned by fired even though the provider didn't load data. + +## New behavior + +Starting in .NET 11, doesn't call `OnReload` after `Load` fails and the `OnLoadException` callback sets to `true`. The reload token doesn't fire because the provider didn't load data. + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +To avoid a notification when no data changes, calls `OnReload` only after it loads data. This behavior resulted from a control-flow fix in [dotnet/runtime#126093](https://github.com/dotnet/runtime/pull/126093). + +## Recommended action + +Don't depend on the reload token when the provider doesn't load data. If your application must run code after an ignored load failure, call that code from your `OnLoadException` callback. + +## Affected APIs + +- +- +- +- diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index 0582ff971eadc..194f456ea87fb 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -50,6 +50,8 @@ items: items: - name: ChangeToken.OnChange async overloads rebind existing Task-returning callbacks href: extensions/11/changetoken-onchange-async-overloads-rebind-callbacks.md + - name: FileConfigurationProvider doesn't raise reload token after ignored load failure + href: extensions/11/fileconfigurationprovider-reload-token-load-failure.md - name: IHost.RunAsync and IHost.StopAsync throw when a BackgroundService fails href: extensions/11/ihost-runasync-stopasync-throw-backgroundservice-failure.md - name: Some Microsoft.Extensions packages included in shared framework From a793aa69a095bd3692be88c1ec895119adf7402f Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 5 Aug 2026 14:43:54 -0700 Subject: [PATCH 3/3] Update docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md --- .../11/fileconfigurationprovider-reload-token-load-failure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md b/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md index 157e192a19ae2..77708e01beee2 100644 --- a/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md +++ b/docs/core/compatibility/extensions/11/fileconfigurationprovider-reload-token-load-failure.md @@ -7,7 +7,7 @@ ai-usage: ai-assisted # FileConfigurationProvider doesn't raise reload token after ignored load failure -In .NET 11, doesn't call `OnReload` or fire its reload token after fails and its callback ignores the exception. + no longer calls `OnReload` or fires its reload token after fails and its callback ignores the exception. ## Version introduced