UriParser.GetComponents(Uri, UriComponents, UriFormat) Method

Definition

Gets the components from a URI.

protected:
 virtual System::String ^ GetComponents(Uri ^ uri, UriComponents components, UriFormat format);
protected virtual string GetComponents (Uri uri, UriComponents components, UriFormat format);
abstract member GetComponents : Uri * UriComponents * UriFormat -> string
override this.GetComponents : Uri * UriComponents * UriFormat -> string

Parameters

uri
Uri

The URI to parse.

components
UriComponents

The UriComponents to retrieve from uri.

format
UriFormat

One of the UriFormat values that controls how special characters are escaped.

Returns

A string that contains the components.

Exceptions

uriFormat is invalid.

-or-

uriComponents is not a combination of valid UriComponents values.

uri requires user-driven parsing

-or-

uri is not an absolute URI. Relative URIs cannot be used with this method.

Remarks

Use the GetComponents method to determine the value of various parts of the URI, such as the Scheme, Host, or Port.

The components are returned in the order that they appear in the URI. For example, if Scheme is specified, it appears first.

Applies to

See also