UriParser::GetComponents Method (Uri^, UriComponents, UriFormat)

.NET Framework (current version)

Gets the components from a URI.

Namespace: System
Assembly: System (in System.dll)

Syntax

protected:
virtual String^ GetComponents(
	Uri^ uri,
	UriComponents components,
	UriFormat format
)

components: Type: System::UriComponents
The UriComponents to retrieve from uri.

format: Type: System::UriFormat
One of the UriFormat values that controls how special characters are escaped.

Type: System::String^

A string that contains the components.

Exception	Condition
ArgumentOutOfRangeException	uriFormat is invalid. - or - uriComponents is not a combination of valid UriComponents values.
InvalidOperationException	uri requires user-driven parsing - or - uri is not an absolute URI. Relative URIs cannot be used with this method.

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.

.NET Framework
Available since 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0