UriTemplate.BindByName 方法

定义

命名空间:

System

程序集:

System.ServiceModel.Web.dll

程序集:

System.ServiceModel.dll

程序集:

System.ServiceModel.dll, System.ServiceModel.Web.dll

利用模板和参数集合创建一个新的 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。