UriBuilder Constructor (String, String, Int32)

Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

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

public:
UriBuilder(
	String^ scheme, 
	String^ host, 
	int portNumber
)

Parameters

scheme
Type: System::String

An Internet access protocol.

host
Type: System::String

A DNS-style domain name or IP address.

portNumber
Type: System::Int32

An IP port number for the service.

ExceptionCondition
ArgumentOutOfRangeException

portNumber 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, and the Port property set to portNumber. The Path property is set to the slash character (/).

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/.

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

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft