Binding documentation is missing important details

[flibustier7seas]

Type of issue

Typo

Description

The documentation is missing important details about how binding works. For example, it does not explain:

1. How binding works with dictionaries:
   • https://learn.microsoft.com/en-us/dotnet/core/compatibility/extensions/7.0/config-bind-dictionary
2. How binding works with dictionaries whose keys can contain a colon:
   • System.InvalidOperationException if configuration has dictionary with colon in key. aspnet/Configuration#792
3. How binding works with IReadOnly* types:
   • Microsoft.Extensions.Configuration: IReadOnlyList Options with default value are not filled runtime#38852
4. How binding works with classes that have multiple parameterized constructors

Page URL

https://learn.microsoft.com/en-us/dotnet/core/extensions/configuration#binding

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/extensions/configuration.md

Document Version Independent Id

0d5de37c-8f89-b6a5-3132-2c5214196bfd

Platform Id

212ae417-5e03-de34-9bd9-b3e8724270df

Article author

@IEvangelist

Metadata

• ID: b458a209-339d-e896-4e85-6d1c6a7aa1f9
• PlatformId: 212ae417-5e03-de34-9bd9-b3e8724270df
• Service: dotnet-fundamentals

Related Issues

---

Associated WorkItem - 551423