[release/6.0] Apply custom Message and Url to all [RequiresPreviewFeatures] attributes

[jeffhandley]

Backport of #60379. Due to conflicts in eng/Versions.props from differences between main and release/6.0, this backport was crafted manually by cherry-picking the commits from #60379. The package version for the NetAnalyzers was set to be the latest version number from the dotnet6 feed.

Customer Impact

With #56498, we have added Message and Url properties to the RequiresPreviewFeatures attribute. With dotnet/roslyn-analyzers#5502, the analyzer now includes those Message and Url properties in the diagnostic messages raised. This change updates the existing [RequiresPreviewFeatures] attributes across the dotnet/runtime repo to apply custom messages and urls.

When we sought approval for dotnet/roslyn-analyzers#5502, we stated that we would be following up with this PR. With this change, diagnostics reported will now provide more information about the preview feature that was used. For example, references to Generic Math APIs will now result in:

Generic Math is in preview. Using 'IAdditionOperators' requires opting into preview features. See https://aka.ms/dotnet-warnings/generic-math-preview for more information.

Without this change, all diagnostic messages from the preview APIs in dotnet/runtime are reported using the standard message:

Using 'IAdditionOperators' requires opting into preview features. See https://aka.ms/dotnet-warnings/preview-features for more information.

The Kestrel HTTP/3 support for .NET 6 is already using custom messages/urls.

Testing

Local testing validated the custom messages are now produced as expected.

Risk

Minimal. Additional properties added into attribute metadata, but no runtime behavior changes.

[ghost]

Tagging subscribers to this area: @dotnet/area-system-runtime
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Backport of #60379. Due to conflicts in eng/Versions.props from differences between main and release/6.0, this backport was crafted manually by cherry-picking the commits from #60379. The package version for the NetAnalyzers was set to be the latest version number from the dotnet6 feed.

Customer Impact

With #56498, we have added Message and Url properties to the RequiresPreviewFeatures attribute. With dotnet/roslyn-analyzers#5502, the analyzer now includes those Message and Url properties in the diagnostic messages raised. This change updates the existing [RequiresPreviewFeatures] attributes across the dotnet/runtime repo to apply custom messages and urls.

When we sought approval for dotnet/roslyn-analyzers#5502, we stated that we would be following up with this PR. With this change, diagnostics reported will now provide more information about the preview feature that was used. For example, references to Generic Math APIs will now result in:

    internal const string PreviewFeatureMessage = "Generic Math is in preview.";
    internal const string PreviewFeatureUrl = "https://aka.ms/dotnet-warnings/generic-math-preview";

Generic Math is in preview. Using 'IAdditionOperators' requires opting into preview features. See https://aka.ms/dotnet-warnings/generic-math-preview for more information.

Without this change, all diagnostic messages from the preview APIs in dotnet/runtime are reported using the standard message:

Using 'IAdditionOperators' requires opting into preview features. See https://aka.ms/dotnet-warnings/preview-features for more information.

The Kestrel HTTP/3 support for .NET 6 is already using custom messages/urls.

Testing

Local testing validated the custom messages are now produced as expected.

Risk

Minimal. Assembly size is affected by adding the strings into the attributes. This is minimized by the generic math API refs being excluded from the shared framework and only included if the System.Runtime.Experimental package is installed.

Author:	jeffhandley
Assignees:	-
Labels:	Servicing-consider, area-System.Runtime
Milestone:	6.0.0

[dotnet-issue-labeler]

Note regarding the new-api-needs-documentation label:

This serves as a reminder for when your PR is modifying a ref *.cs file and adding/modifying public APIs, to please make sure the API implementation in the src *.cs file is documented with triple slash comments, so the PR reviewers can sign off that change.