No mention of [ValidateObjectMembers]?

[fterrani]

Type of issue

Missing information

Description

Greetings.

Apparently, there is no mention of the [ValidateObjectMembers] attribute (Microsoft.Extensions.Options.ValidateObjectMembersAttribute). Without it and as you already know, validation doesn't propagate recursively to object members which is (in my humble opinion) rather unintuitive. Since nothing warned me about this, I spent hours trying to figure out why validation didn't occur.

I actually didn't find any documentation about it besides at dotnet/runtime#36093 .

Page URL

https://learn.microsoft.com/en-us/dotnet/core/extensions/options

Content source URL

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

Document Version Independent Id

00449cdc-b8fc-a9ff-3f20-0ef0994db354

Platform Id

fa207b6b-9c25-033b-aa53-fead35cb2436

Article author

@IEvangelist

Metadata

• ID: 433988ea-fda9-aa83-f6ee-221a5521a422
• PlatformId: fa207b6b-9c25-033b-aa53-fead35cb2436
• Service: dotnet-fundamentals

Related Issues

[IEvangelist]

Good catch, yeah - we should probably document both of these:

• ValidateObjectMembersAttribute
• ValidateEnumeratedItemsAttribute

As they do differ from the Compile-time options validation source generation content we have now.

[fterrani]

The Options pattern page is getting long. How about grouping all option validation-related content to a new Options validation page that would contain:

• The content of the current Options validation section
• And then a Compile-time options validation source generation section?