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

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
)

Parameters

scheme
Type: System.String

An Internet access protocol.

host
Type: System.String

A DNS-style domain name or IP address.

port
Type: System.Int32

An IP port number for the service.

path
Type: System.String

The path to the Internet resource.

extraValue
Type: System.String

A query string or fragment identifier.

ExceptionCondition
ArgumentException

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 (?).

ArgumentOutOfRangeException

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");

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft