Article
11/18/2011

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

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

'Declaration
Public Sub New ( _
    scheme As String, _
    host As String, _
    port As Integer, _
    path As String, _
    extraValue As String _
)

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 nulla null reference (Nothing in Visual Basic) nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?) -or- scheme is not a valid scheme name.
ArgumentOutOfRangeException	port is less than 0 or greater than 65,535.

ArgumentException

extraValue is neither nulla null reference (Nothing in Visual Basic) nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?)

-or-

scheme is not a valid scheme name.

ArgumentOutOfRangeException

port is less than 0 or greater than 65,535.

Remarks

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.

Examples

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

  Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm", "#top")

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Partager via