UriParser.GetComponents Method (Uri, UriComponents, UriFormat)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the components from a URI.

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

Protected Overridable Function GetComponents (
	uri As Uri,
	components As UriComponents,
	format As UriFormat
) As String


Type: System.Uri

The URI to parse.

Type: System.UriComponents

The UriComponents to retrieve from uri.

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

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.

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
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top