GetComponents Method
Collapse the table of content
Expand the table of content

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

 

Gets the components from a URI.

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

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

Parameters

uri
Type: System::Uri^

The URI to parse.

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.

Return Value

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
Return to top
Show:
© 2016 Microsoft