UriBuilder 构造函数

定义

初始化 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

初始化 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
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 字符串。

例外

urinull

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

- 或 -

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

- 或 -

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

- 或 -

uri 不是有效的 URI。

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

注解

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

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

适用于

UriBuilder(Uri)

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 类的实例。

例外

urinull

注解

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

适用于

UriBuilder(String, String)

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 = 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 属性设置为 schemeNameHost 属性设置为 hostNamePort 初始化为值 -1 以指示应使用方案的默认端口,并将 Path 属性设置为 /) (斜杠字符。

适用于

UriBuilder(String, String, Int32)

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 端口号。

例外

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 属性设置为 schemeNameHost 属性设置为 hostNamePort 属性设置为 portNumber。 属性 Path 设置为 /) (斜杠字符。

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

适用于

UriBuilder(String, String, Int32, String)

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 资源的路径。

例外

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 ,属性设置为 schemeNameHost 属性设置为 hostNamePort 属性设置为 portNumberPath 属性设置为 pathValue

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

适用于

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

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

查询字符串或段标识符。

例外

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

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 ,属性设置为 schemeNameHost 属性设置为 hostNamePort 属性设置为 portNumberPath 属性设置为 pathValue。 如果 extraValue 以数字符号 (#) 开头,则 Fragment 设置为 extraValue。 如果 extraValue 以问号 (?) 开头,则 Query 设置为 extraValue

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

适用于