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.
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.
| 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.
The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/index.htm#top.
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