search

dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
719 stars 1.56k forks source link

Missing Remarks For CultureInfo About InvariantGlobalization #10271

Open charleyah opened 2 months ago

charleyah commented 2 months ago

Type of issue

Missing information

Description

There is no remarks about how InvariantGlobalization impacts what CultureInfo is decided for the relevant static properties.

I could not detect the system culture set by the user through the following properties because InvariantGlobalization had been enabled by default without my acknowledgement when I created a new .NET 8 C# project in VS 2022.

CultureInfo.CurrentCulture 
CultureInfo.CurrentUICulture
CultureInfo.InstalledUICulture

I only discovered InvariantGlobalization was enabled after trying to find non-invariant culture by name using CultureInfo.GetCultureInfo

CurrentCultures are more complex due to being per thread and changable, but I think at least InstalledUICulture needs some remarks about being overriden by InvariantGlobalization.

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo?view=net-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Globalization/CultureInfo.xml

Document Version Independent Id

4c239615-7734-6c50-7802-99e401b0eb28

Article author

@dotnet-bot

dotnet-policy-service[bot] commented 2 months ago

Tagging subscribers to this area: @dotnet/area-system-globalization