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

Универсальный код ресурса.

Комментарии

Параметр 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 содержит коллекцию пар «имя-значение» для параметров. Параметры сравниваются с переменными в шаблоне с учетом регистра символов. Значения, передаваемые в этой коллекции, преобразуются в escape-последовательности.

Примечание

Коллекция пар "имя-значение", передаваемая методу 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

Универсальный код ресурса.

Применяется к

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

Универсальный код ресурса.

Применяется к