共用方式為


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

來源:
UriBuilder.cs
來源:
UriBuilder.cs
來源:
UriBuilder.cs

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

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

備註

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

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

適用於

UriBuilder(String)

來源:
UriBuilder.cs
來源:
UriBuilder.cs
來源:
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 是零長度字串或只包含空格。

-或-

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

-或-

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

-或-

uri 不是有效的 URI。

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

備註

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

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

適用於

UriBuilder(Uri)

來源:
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 類別的執行個體。

例外狀況

urinull

備註

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

適用於

UriBuilder(String, String)

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

適用於

UriBuilder(String, String, Int32)

來源:
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 連接埠編號。

例外狀況

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 屬性設定為 schemeNameHost屬性設定hostName為 ,並將 Port 屬性設定為portNumberScheme 屬性 Path 會設定為 /) (斜線字元。

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

適用於

UriBuilder(String, String, Int32, String)

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

網際網路資源的路徑。

例外狀況

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.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

查詢字串或片段識別項。

例外狀況

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

備註

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

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

適用於