Skip to content

docs: clarify IOptionsSnapshot<T> performance characteristics#53895

Open
heissenberg06 wants to merge 1 commit into
dotnet:mainfrom
heissenberg06:fix/options-snapshot-perf-docs
Open

docs: clarify IOptionsSnapshot<T> performance characteristics#53895
heissenberg06 wants to merge 1 commit into
dotnet:mainfrom
heissenberg06:fix/options-snapshot-perf-docs

Conversation

@heissenberg06
Copy link
Copy Markdown
Contributor

@heissenberg06 heissenberg06 commented May 20, 2026

Summary

Added a "Performance considerations" subsection under the
"Use IOptionsSnapshot to read updated data" section to clarify
that IOptionsSnapshot<T> recomputes the full options pipeline
on every scope, regardless of whether configuration has changed,
and documents cheaper alternatives (IOptions<T> and
IOptionsMonitor<T>).

Fixes #53890


Internal previews

📄 File 🔗 Preview link
docs/core/extensions/options.md Options pattern in .NET

@heissenberg06 heissenberg06 requested review from a team and gewarren as code owners May 20, 2026 14:10
@dotnetrepoman dotnetrepoman Bot added this to the May 2026 milestone May 20, 2026
@dotnet-policy-service dotnet-policy-service Bot added dotnet-fundamentals/svc community-contribution Indicates PR is created by someone from the .NET community. labels May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community. dotnet-fundamentals/svc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: clarify IOptionsSnapshot<T> performance characteristics

1 participant