Document members of CultureInsensitiveTypeAttribute.

[drieseng]

No description provided.

[drieseng]

I could not compile locally. I first had to change target framework .NET 10 to .NET 9 since I don't yet have the VS2026 preview installed.

Even then I got the following compile errors:

.NET 9.0 build

2>Meziantou.Polyfill\Meziantou.Polyfill.PolyfillGenerator\T_System.Runtime.CompilerServices.DefaultInterpolatedStringHandler.g.cs(593,39,593,44): error CS0117: 'Math' does not contain a definition for 'Clamp'

.NET Standard 2.0 build

Meziantou.Analyzer\src\Meziantou.Analyzer\obj\Debug\netstandard2.0\Meziantou.Polyfill\Meziantou.Polyfill.PolyfillGenerator\T_System.Runtime.CompilerServices.DefaultInterpolatedStringHandler.g.cs(593,39,593,44): error CS0117: 'Math' does not contain a definition for 'Clamp'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasTimeProviderAnalyzer.cs(141,43,141,46): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasTimeProviderAnalyzer.cs(264,40,264,43): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasTimeProviderAnalyzer.cs(266,42,266,45): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasCancellationTokenAnalyzer.cs(239,56,239,59): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasCancellationTokenAnalyzer.cs(373,40,373,43): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\UseAnOverloadThatHasCancellationTokenAnalyzer.cs(375,42,375,45): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\FileNameMustMatchTypeNameAnalyzer.cs(113,69,113,72): error CS1503: Argument 1: cannot convert from 'char' to 'string'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\MethodOverridesShouldNotChangeParameterDefaultsAnalyzer.cs(100,23,100,29): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(564,50,564,56): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(589,50,589,56): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(612,46,612,52): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(635,46,635,52): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(657,46,657,52): error CS0117: 'string' does not contain a definition for 'Create'
Meziantou.Analyzer\src\Meziantou.Analyzer\Rules\OptimizeLinqUsageAnalyzer.cs(679,46,679,52): error CS0117: 'string' does not contain a definition for 'Create'

How come you can compile for .NET Standard 2.0 while using methods that are only available in .NET?

[meziantou]

How come you can compile for .NET Standard 2.0 while using methods that are only available in .NET?

The project requires .NET SDK 10 to build. It uses meziantou/Meziantou.Polyfill, a source generator that allows using newer types/methods/properties on older TFMs.

In your case there is a bug (I don't know if I will fix it), where it wants to polyfill a type that uses another polyfill that C# 14 is needed (extension). Math.Clamp should not be generated as it requires extensions, but the check is not transitive and the DefaultInterpolatedStringHandler is generated.

[Copilot]

Pull Request Overview

This PR adds comprehensive XML documentation to the CultureInsensitiveTypeAttribute class, improving code maintainability and API understanding. The documentation explains how the attribute can be used to mark types and formats as culture insensitive.

Key Changes:

• Added XML documentation to all five constructor overloads explaining their purpose and usage scenarios
• Documented all three public properties (Type, Format, IsDefaultFormatCultureInsensitive) with descriptions and value explanations

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[meziantou]

Thanks!