UriBuilder 构造函数

定义

命名空间:

System

程序集:

System.Runtime.dll

初始化 UriBuilder 类的新实例。

重载

UriBuilder()	初始化 UriBuilder 类的新实例。
UriBuilder(String)	用指定的 URI 初始化 UriBuilder 类的新实例。
UriBuilder(Uri)	使用指定的 UriBuilder 实例初始化 Uri 类的新实例。
UriBuilder(String, String)	用指定的方案和主机初始化 UriBuilder 类的新实例。
UriBuilder(String, String, Int32)	用指定的方案、主机和端口初始化 UriBuilder 类的新实例。
UriBuilder(String, String, Int32, String)	用指定的方案、主机、端口号和路径初始化 UriBuilder 类的新实例。
UriBuilder(String, String, Int32, String, String)	使用指定的方案、主机、端口号、路径和查询字符串或片段标识符初始化 类的新实例 UriBuilder 。

UriBuilder()

Source:

UriBuilder.cs

初始化 UriBuilder 类的新实例。

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

注解

无参数构造函数创建 类的新实例 UriBuilder ，其属性初始化如下。

properties	初始值
Fragment	Empty
主机	“loopback”
Password	Empty
路径	"/"
Port	-1
查询	Empty
Scheme	“http”
UserName	Empty

UriBuilder(String)

Source:

UriBuilder.cs

用指定的 URI 初始化 UriBuilder 类的新实例。

public:
 UriBuilder(System::String ^ uri);

public UriBuilder (string uri);

new UriBuilder : string -> UriBuilder

Public Sub New (uri As String)

参数

uri

String

一个 URI 字符串。

例外

ArgumentNullException

uri 为 null。

UriFormatException

uri 字符串长度为零或只包含空格。

- 或 -

分析例程检测到格式无效的架构。

- 或 -

分析器在不使用 "file" 架构的 URI 中检测到两个以上的连续斜杠。

- 或 -

uri 不是有效的 URI。

注意：在 .NET for Windows 应用商店应用 或 可移植类库中，请改为捕获基类异常 FormatException。

注解

此构造函数使用 中指定的 、、、QuerySchemePortPath、 和 Uri 属性初始化 类的新实例。UriBuilderHosturiFragment

如果未 uri 指定方案，则方案默认为“http：”。

UriBuilder(Uri)

Source:

UriBuilder.cs

使用指定的 UriBuilder 实例初始化 Uri 类的新实例。

public:
 UriBuilder(Uri ^ uri);

public UriBuilder (Uri uri);

new UriBuilder : Uri -> UriBuilder

Public Sub New (uri As Uri)

参数

uri

Uri

Uri 类的实例。

例外

ArgumentNullException

uri 上声明的默认值为 null。

注解

此构造函数使用 中指定的 、、、QuerySchemePortPath、 和 Uri 属性初始化 类的新实例。UriBuilderHosturiFragment

UriBuilder(String, String)

Source:

UriBuilder.cs

用指定的方案和主机初始化 UriBuilder 类的新实例。

public:
 UriBuilder(System::String ^ schemeName, System::String ^ hostName);

public UriBuilder (string? schemeName, string? hostName);

new UriBuilder : string * string -> UriBuilder

Public Sub New (schemeName As String, hostName As String)

参数

schemeName

String

Internet 访问协议。

hostName

String

DNS 样式的域名或 IP 地址。

示例

以下示例创建一个 UriBuilder 包含 URI http://www.contoso.com/的实例。

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

UriBuilder myUri = new UriBuilder("http","www.contoso.com");

let myUri = UriBuilder "http","www.contoso.com"

Dim myUri As New UriBuilder("http", "www.contoso.com")

注解

实例 UriBuilder 初始化时， Scheme 属性设置为 schemeName ， Host 属性设置为 hostName。 Port 初始化为值 -1 以指示应使用方案的默认端口，并将 Path 属性设置为 /) (斜杠字符。

UriBuilder(String, String, Int32)

Source:

UriBuilder.cs

用指定的方案、主机和端口初始化 UriBuilder 类的新实例。

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

public UriBuilder (string? scheme, string? host, int portNumber);

new UriBuilder : string * string * int -> UriBuilder

Public Sub New (scheme As String, host As String, portNumber As Integer)

参数

scheme

String

Internet 访问协议。

host

String

DNS 样式的域名或 IP 地址。

portNumber

Int32

服务的 IP 端口号。

例外

ArgumentOutOfRangeException

portNumber 小于 -1 或大于 65,535。

示例

以下示例创建一个 UriBuilder 包含 URI http://www.contoso.com:8080/的实例。

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

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

let myUri = UriBuilder("http","www.contoso.com", 8080)

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080)

注解

实例 UriBuilder 初始化时， Scheme 属性设置为 schemeName， Host 属性设置为 hostName， Port 属性设置为 portNumber。 属性 Path 设置为 /) (斜杠字符。

portNumber如果 设置为 -1 的值，则表示方案的默认端口值将用于连接到主机。

UriBuilder(String, String, Int32, String)

Source:

UriBuilder.cs

用指定的方案、主机、端口号和路径初始化 UriBuilder 类的新实例。

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ pathValue);

public UriBuilder (string? scheme, string? host, int port, string? pathValue);

new UriBuilder : string * string * int * string -> UriBuilder

Public Sub New (scheme As String, host As String, port As Integer, pathValue As String)

参数

scheme

String

Internet 访问协议。

host

String

DNS 样式的域名或 IP 地址。

port

Int32

服务的 IP 端口号。

pathValue

String

Internet 资源的路径。

例外

ArgumentOutOfRangeException

port 小于 -1 或大于 65,535。

示例

以下示例创建一个 UriBuilder 包含 URI http://www.contoso.com:8080/index.htm的实例。

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

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

let myUri = UriBuilder("http","www.contoso.com", 8080, "index.htm")

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

注解

实例 UriBuilder 初始化时 Scheme ，属性设置为 schemeName， Host 属性设置为 hostName， Port 属性设置为 portNumber， Path 属性设置为 pathValue。

portNumber如果 设置为 -1 的值，则表示方案的默认端口值将用于连接到主机。

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

Source:

UriBuilder.cs

使用指定的方案、主机、端口号、路径和查询字符串或片段标识符初始化 类的新实例 UriBuilder 。

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ path, System::String ^ extraValue);

public UriBuilder (string? scheme, string? host, int port, string? path, string? extraValue);

new UriBuilder : string * string * int * string * string -> UriBuilder

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

参数

scheme

String

Internet 访问协议。

host

String

DNS 样式的域名或 IP 地址。

port

Int32

服务的 IP 端口号。

path

String

Internet 资源的路径。

extraValue

String

查询字符串或段标识符。

例外

ArgumentException

extraValue 既不是 null 也不是 Empty，既不是以井号 (#) 开始的有效段标识符，也不是以问号 (?) 开始的有效查询字符串。

ArgumentOutOfRangeException

port 小于 -1 或大于 65,535。

示例

以下示例创建一个 UriBuilder 包含 URI http://www.contoso.com:8080/index.htm#top的实例。

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

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

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

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

注解

实例 UriBuilder 初始化时 Scheme ，属性设置为 schemeName， Host 属性设置为 hostName， Port 属性设置为 portNumber， Path 属性设置为 pathValue。 如果 extraValue 以数字符号 (#) 开头，则 Fragment 设置为 extraValue。 如果 extraValue 以问号 (？) 开头，则 Query 设置为 extraValue。

portNumber如果 设置为 -1 的值，则表示方案的默认端口值将用于连接到主机。