UriBuilder 建構函式

定義

命名空間:: System

組件:: System.dll, System.Runtime.Extensions.dll

組件:: netstandard.dll, System.Runtime.dll

組件:: System.Runtime.Extensions.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 UriBuilder 類別的新執行個體。

多載

名稱	Description
UriBuilder()	初始化 UriBuilder 類別的新執行個體。
UriBuilder(String)	初始化一個新的類別實例 UriBuilder ，使用指定的 URI。
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()

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

初始化 UriBuilder 類別的新執行個體。

public:
 UriBuilder();

public UriBuilder();

Public Sub New ()

備註

無參數建構子會建立一個新的類別實例 UriBuilder ，其屬性初始化如下。

房產	初始值
Fragment	Empty
Host	「迴圈」
Password	Empty
路徑	"/"
Port	-1
Query	Empty
Scheme	「http」
UserName	Empty

適用於

UriBuilder(String)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

初始化一個新的類別實例 UriBuilder ，使用指定的 URI。

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 是零長度的字串，或僅包含空格。

-或-

解析程序偵測到一個格式為無效形式。

-或-

解析器偵測到未使用「檔案」方案的 URI 中連續出現超過兩個斜杠。

-或-

uri 不是有效的 URI。

注意：在.NET中，對於Windows Store 應用程式或Portable Class Library，請選擇基底類別例外，FormatException。

備註

此建構器初始化類別的新實例UriBuilder，並依 Fragment Host Path Port Query Scheme Uri 、及屬性設定於。uri

若 uri 未指定方案，該方案預設為「http：」。

適用於

UriBuilder(Uri)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: 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。

備註

此建構器初始化類別的新實例UriBuilder，並依 Fragment Host Path Port Query Scheme Uri 、及屬性設定於。uri

適用於

UriBuilder(String, String)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: 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

一種網際網路存取協定。

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")

備註

UriBuilder實例初始化時屬性Scheme設為，schemeNameHost屬性設hostName為。 Port 初始化為 -1 的值，以表示該方案的預設埠，屬性 Path 設為斜杠（/）。

適用於

UriBuilder(String, String, Int32)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: 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

一種網際網路存取協定。

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)

備註

實 UriBuilder 例初始化時屬性 Scheme 設 schemeName為， Host 屬性設為 hostName，屬性設為， Port 屬性設為 portNumber。屬性 Path 設定為斜線字元（/）。

若設定 portNumber 為 -1，表示該方案的預設埠值將用於連接主機。

適用於

UriBuilder(String, String, Int32, String)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: 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

一種網際網路存取協定。

host: String

一個類似 DNS 的網域名稱或 IP 位址。

port: Int32

服務的 IP 埠號。

pathValue: String

通往網際網路資源的路徑。

例外狀況

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)

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: UriBuilder.cs

來源:: 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

一種網際網路存取協定。

host: String

一個類似 DNS 的網域名稱或 IP 位址。

port: Int32

服務的 IP 埠號。

path: String

通往網際網路資源的路徑。

extraValue: String

查詢字串或片段識別碼。

例外狀況

ArgumentException

extraValue既不是也null不是，也不是Empty，且有效的片段識別碼不會以數字符號（#）開頭，有效的查詢字串也不會以問號（？）開頭。

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，表示該方案的預設埠值將用於連接主機。

適用於

意見反應

此頁面對您有幫助嗎？