UriBuilder Constructor (String, String, Int32, String, String)


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

Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

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

public UriBuilder(
	string scheme,
	string host,
	int port,
	string path,
	string extraValue


Type: System.String

An Internet access protocol.

Type: System.String

A DNS-style domain name or IP address.

Type: System.Int32

An IP port number for the service.

Type: System.String

The path to the Internet resource.

Type: System.String

A query string or fragment identifier.

Exception Condition

extraValue is neither null nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?).


port is less than -1 or greater than 65,535.

The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber, and the Path property is set to pathValue. If extraValue begins with a number sign (#), then Fragment is set to extraValue. If extraValue begins with a question mark (?), then Query is set to extraValue.

If the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/index.htm#top.

UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm","#top");

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top