diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml index c0cec77e4be..7b9fda102ac 100644 --- a/xml/System/Uri.xml +++ b/xml/System/Uri.xml @@ -2442,6 +2442,12 @@ If you used an escaped string to construct this instance (for example, `"http:// The method returns a string containing the leftmost portion of the URI string, ending with the portion specified by `part`. +> [!IMPORTANT] +> The method performs Unicode character encoding and normalization as part of its processing. It is not a simple string manipulation method. The returned string may differ from the original URI string due to this encoding behavior. + +The method is equivalent to calling with the appropriate flags. For example: +- `GetLeftPart(UriPartial.Authority)` is equivalent to `GetComponents(UriComponents.Scheme | UriComponents.UserInfo | UriComponents.Host | UriComponents.Port, UriFormat.UriEscaped)` + includes delimiters in the following cases: - includes the scheme delimiter.