System.UriTemplate.BindByName 方法 (Uri, NameValueCollection)

方法描述

利用模板和参数集合创建一个新的 URI。

语法定义(C# System.UriTemplate.BindByName 方法 (Uri, NameValueCollection) 的用法)

public Uri BindByName(
	Uri baseAddress,
	NameValueCollection parameters
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
baseAddress System-Uri 基址。
parameters System-Collections-Specialized-NameValueCollection 参数值。
返回值 System.Uri 新实例。

提示和注释

NameValueCollection 参数包含参数名称/值对的集合。将参数与模板中的变量匹配时使用区分大小写的比较。传入此集合中的值都会经过转义。

注意

传递给 BindByName(Uri, NameValueCollection) 的名称/值集合必须包含每个模板变量的键值。与模板变量不匹配的额外名称/值对会追加到最终 URI 的查询字符串之后。

注意

您可以在名称/值对中传入文本,以阻止生成的 URI 与用于生成它的模板匹配。此类文本包括“/”、“..”、“*”、“{”和“}”等。

System.UriTemplate.BindByName 方法 (Uri, NameValueCollection)例子

下面的示例演示如何调用 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);

异常

异常 异常描述

命名空间

namespace: System

程序集: System.ServiceModel(在 System.ServiceModel.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。