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

來源:

UriBuilder.cs

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

public:
 UriBuilder();

public UriBuilder ();

Public Sub New ()

備註

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

屬性	初始值
片段	Empty
主機	“回送”
密碼	Empty
路徑	"/"
Port	-1
查詢	Empty
配置	“http”
UserName	Empty

UriBuilder(String)

來源:

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

-或-

剖析常式偵測到格式無效的配置。

-或-

剖析器在不是使用「檔案」配置的 URI 中偵測到兩個以上連續的斜線。

-或-

uri 不是有效的 URI。

注意：在 適用於 Windows 市集應用程式的 .NET 或 可攜式類別庫中，改為攔截基類例外狀況 FormatException。

備註

這個建構函式會UriBuilder初始化 類別的新實例，並使用 Fragment中所uri指定的 、Host、PathPort、Query、Scheme、 和 Uri 屬性。

如果未 uri 指定配置，則配置預設為 「HTTP：“。

UriBuilder(Uri)

來源:

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中所uri指定的 、Host、PathPort、Query、Scheme、 和 Uri 屬性。

UriBuilder(String, String)

來源:

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

網際網路存取通訊協定。

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 屬性設定schemeNameHost為hostName。Scheme Port 初始化為值 -1，以指出應該使用配置的預設埠，而且 Path 屬性會設定為斜線字元 (/) 。

UriBuilder(String, String, Int32)

來源:

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

網際網路存取通訊協定。

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 屬性設定為 schemeName、Host屬性設定hostName為 ，並將 Port 屬性設定為portNumber。Scheme 屬性 Path 會設定為 /) (斜線字元。

portNumber如果 設定為 -1 的值，這表示配置的預設埠值將用來連線到主機。

UriBuilder(String, String, Int32, String)

來源:

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

網際網路存取通訊協定。

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

備註

實體初始化時，屬性設定為 、屬性設定為、Port屬性設定portNumber為 ，並將 Path 屬性設定為UriBuilderpathValueSchemeschemeNamehostNameHost

portNumber如果 設定為 -1 的值，這表示配置的預設埠值將用來連線到主機。

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

來源:

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

網際網路存取通訊協定。

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

備註

實體初始化時，屬性設定為 、屬性設定為、Port屬性設定portNumber為 ，並將 Path 屬性設定為UriBuilderpathValueSchemeschemeNamehostNameHost 如果 extraValue 開頭為數字符號 (#) ，則 Fragment 會設定為 extraValue。 如果 extraValue 開頭為問號 (？) ，則會 Query 設定為 extraValue。

portNumber如果 設定為 -1 的值，這表示配置的預設埠值將用來連線到主機。