共用方式為


UriTemplate.BindByName 方法

定義

從範本和參數集合建立新的 URI。

多載

BindByName(Uri, IDictionary<String,String>)

從範本和參數集合建立新的 URI。

BindByName(Uri, NameValueCollection)

從範本和參數集合建立新的 URI。

BindByName(Uri, IDictionary<String,String>, Boolean)

從範本和參數集合建立新的 URI。

BindByName(Uri, NameValueCollection, Boolean)

從範本和參數集合建立新的 URI。

BindByName(Uri, IDictionary<String,String>)

從範本和參數集合建立新的 URI。

public:
 Uri ^ BindByName(Uri ^ baseAddress, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ parameters);
public Uri BindByName (Uri baseAddress, System.Collections.Generic.IDictionary<string,string> parameters);
member this.BindByName : Uri * System.Collections.Generic.IDictionary<string, string> -> Uri
Public Function BindByName (baseAddress As Uri, parameters As IDictionary(Of String, String)) As Uri

參數

baseAddress
Uri

基底位址。

parameters
IDictionary<String,String>

字典,其中包含參數名稱/值組的集合。

傳回

Uri

URI。

備註

IDictionary <string,string> 參數包含參數名稱和值組的集合。 參數與樣板內的變數會以不區分大小寫方式進行比對。

注意

傳遞至這個方法的名稱/值集合必須包含每個樣板變數的索引鍵。 不符合樣板變數的額外名稱/值組會附加至最終 URI 的查詢字串。

重要

您可以在名稱/值組內傳入文字,名稱/值組不會使所產生的 URI 與用於產生它的樣板相符。 這類文字的範例包括:'/'、'..'、'*'、'{' 和 '}'。

適用於

BindByName(Uri, NameValueCollection)

從範本和參數集合建立新的 URI。

public:
 Uri ^ BindByName(Uri ^ baseAddress, System::Collections::Specialized::NameValueCollection ^ parameters);
public Uri BindByName (Uri baseAddress, System.Collections.Specialized.NameValueCollection parameters);
member this.BindByName : Uri * System.Collections.Specialized.NameValueCollection -> Uri
Public Function BindByName (baseAddress As Uri, parameters As NameValueCollection) As Uri

參數

baseAddress
Uri

基底位址。

parameters
NameValueCollection

參數值。

傳回

Uri

新的執行個體。

範例

下列範例會示範如何呼叫 BindByName(Uri, NameValueCollection) 方法。

UriTemplate template = new UriTemplate("weather/{state}/{city}?forecast={day}");
Uri prefix = new Uri("http://localhost");

NameValueCollection parameters = new NameValueCollection();
parameters.Add("state", "Washington");
parameters.Add("city", "Redmond");
parameters.Add("day", "Today");
Uri namedUri = template.BindByName(prefix, parameters);
Dim template As UriTemplate = New UriTemplate("weather/{state}/{city}?forecast={day}")
Dim prefix As Uri = New Uri("http://localhost")

Dim parameters As NameValueCollection = New NameValueCollection()
parameters.Add("state", "Washington")
parameters.Add("city", "Redmond")
parameters.Add("day", "Today")
Dim namedUri As Uri = template.BindByName(prefix, parameters)

備註

NameValueCollection 參數,其中包含參數名稱/值組的集合。 參數與樣板內的變數會以不區分大小寫方式進行比對。 傳到這個集合中的值會逸出。

注意

傳遞至 BindByName(Uri, NameValueCollection) 的名稱/值集合必須包含每個樣板變數的索引鍵。 不符合樣板變數的額外名稱/值組會附加至最終 URI 的查詢字串。

注意

您可以在名稱/值組內傳入文字,名稱/值組不會使所產生的 URI 與用於產生它的樣板相符。 這類文字的範例包括:'/'、'..'、'*'、'{' 和 '}'。

適用於

BindByName(Uri, IDictionary<String,String>, Boolean)

從範本和參數集合建立新的 URI。

public:
 Uri ^ BindByName(Uri ^ baseAddress, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ parameters, bool omitDefaults);
public Uri BindByName (Uri baseAddress, System.Collections.Generic.IDictionary<string,string> parameters, bool omitDefaults);
member this.BindByName : Uri * System.Collections.Generic.IDictionary<string, string> * bool -> Uri
Public Function BindByName (baseAddress As Uri, parameters As IDictionary(Of String, String), omitDefaults As Boolean) As Uri

參數

baseAddress
Uri

包含基底位址的 URI。

parameters
IDictionary<String,String>

字典,其中包含參數名稱/值組的集合。

omitDefaults
Boolean

如果忽略預設值,則為 true;否則為 false

傳回

Uri

URI。

適用於

BindByName(Uri, NameValueCollection, Boolean)

從範本和參數集合建立新的 URI。

public:
 Uri ^ BindByName(Uri ^ baseAddress, System::Collections::Specialized::NameValueCollection ^ parameters, bool omitDefaults);
public Uri BindByName (Uri baseAddress, System.Collections.Specialized.NameValueCollection parameters, bool omitDefaults);
member this.BindByName : Uri * System.Collections.Specialized.NameValueCollection * bool -> Uri
Public Function BindByName (baseAddress As Uri, parameters As NameValueCollection, omitDefaults As Boolean) As Uri

參數

baseAddress
Uri

基底位址。

parameters
NameValueCollection

參數名稱/值組的集合。

omitDefaults
Boolean

如果忽略預設值,則為 true;否則為 false

傳回

Uri

URI。

適用於