Fix incorrect UriBuilder.Scheme property documentation about valid schemes #11648
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The
UriBuilder.Scheme
property documentation contained a misleading table that suggested only specific schemes (file, ftp, gopher, http, https, mailto, news) were valid. This was incorrect.The actual implementation validates scheme names according to RFC 2396 via
System.Uri.CheckSchemeName
, which allows any valid URI scheme per the RFC specification, not just the predefined list shown in the documentation.Before:
The remarks section showed a table listing specific "valid scheme names" that implied these were the only acceptable values.
After:
The remarks now accurately state: "The set accessor validates the scheme name for validity according to RFC 2396. The scheme name must begin with a letter and must contain only letters, digits, and the characters '.', '+', or '-'."
This change:
System.Uri
)x-custom-protocol
ormy-scheme
as long as they comply with RFC 2396Fixes #11626.
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.