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

.NET Framework (current version)

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)

Syntax

C++

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.

Exceptions

Exception	Condition
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.

Examples

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

C++

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

Version Information

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