diff --git a/docs/core/compatibility/11.md b/docs/core/compatibility/11.md index 1739e483dfa80..c6bc3c8824311 100644 --- a/docs/core/compatibility/11.md +++ b/docs/core/compatibility/11.md @@ -64,6 +64,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 | | [FileConfigurationSource.OnLoadException callback is called for IO errors](extensions/11/fileconfigurationsource-onloadexception-io-errors.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..77708e01beee2 --- /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 + + no longer calls `OnReload` or fires 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 e6eb472778904..1b3576fc4cc91 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -58,6 +58,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: FileConfigurationSource.OnLoadException callback is called for IO errors href: extensions/11/fileconfigurationsource-onloadexception-io-errors.md - name: IHost.RunAsync and IHost.StopAsync throw when a BackgroundService fails