UriBuilder 建構函式

  • 參考

定義

命名空間:
System
組件:
System.Runtime.Extensions.dll
組件:
System.Runtime.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()

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

例外狀況

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.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 中所 uri 指定的 、 Host 、 PathPort 、 Query 、 Scheme 、 和 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 屬性設定 schemeNameHost 為 hostName 。 Scheme 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 連接埠編號。

例外狀況

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

備註

實例初始化時，屬性設定為 、 Host 屬性設定 hostName 為 、 Port 屬性設定 portNumber 為 ，並將 Path 屬性設定為 pathValue 。 schemeNameUriBuilderScheme

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

查詢字串或片段識別項。

例外狀況

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

備註

實例初始化時，屬性設定為 、 Host 屬性設定 hostName 為 、 Port 屬性設定 portNumber 為 ，並將 Path 屬性設定為 pathValue 。 schemeNameUriBuilderScheme 如果 extraValue 開頭為數字元號 (#) ，則 Fragment 會設定為 extraValue 。 如果 extraValue 開頭為問號 (？) ，則會 Query 設定為 extraValue 。

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

適用於