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);
版本信息
.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 系统要求。