This documentation is archived and is not being maintained.

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 nullptr 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 = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm","#top" );


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: