通过

UriBuilder 构造函数

定义

命名空间:
System
程序集:
System.dll, System.Runtime.Extensions.dll
程序集:
netstandard.dll, System.Runtime.dll
程序集:
System.Runtime.Extensions.dll
程序集:
System.dll
程序集:
netstandard.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
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs

初始化 UriBuilder 类的新实例。

public:
 UriBuilder();
public UriBuilder();
Public Sub New ()

注解

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

财产 初始值
Fragment Empty
主机 “loopback”
密码 Empty
路径 "/"
港口 -1
查询 Empty
Scheme “http”
UserName Empty

适用于

UriBuilder(String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
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。

注解

此构造函数使用在指定uri中指定的 、Host、Path、PortQuery、 Scheme和Uri属性初始化类Fragment的新实例UriBuilder。

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

适用于

UriBuilder(Uri)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
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。

注解

此构造函数使用在指定uri中指定的 、Host、Path、PortQuery、 Scheme和Uri属性初始化类Fragment的新实例UriBuilder。

适用于

UriBuilder(String, String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs

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

public:
 UriBuilder(System::String ^ schemeName, System::String ^ hostName);
public UriBuilder(string schemeName, 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 = new UriBuilder("http","www.contoso.com");

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

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

注解

实例初始化时，属性设置为 > 和属性设置为 . Port 初始化为值 -1 以指示应使用方案的默认端口，并且该 Path 属性设置为斜杠字符（/）。

适用于

UriBuilder(String, String, Int32)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs

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

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int portNumber);
public UriBuilder(string scheme, 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 = 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)

注解

实例初始化时，属性设置为 ，属性设置为 ，属性设置为 。 该 Path 属性设置为斜杠字符（/）。

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

适用于

UriBuilder(String, String, Int32, String)

Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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 = 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
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
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);
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既不是nullEmpty有效片段标识符，也不是以数字符号（#）开头，也不是有效的查询字符串以问号开头（？）。

ArgumentOutOfRangeException

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

示例

以下示例创建一个 UriBuilder 包含 URI 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 值，则表示方案的默认端口值将用于连接到主机。

适用于