Partilhar via


UriTemplate.BindByName Método

Definição

Cria um novo URI de modelo e a coleção de parâmetros.

Sobrecargas

BindByName(Uri, IDictionary<String,String>)

Cria um novo URI de modelo e a coleção de parâmetros.

BindByName(Uri, NameValueCollection)

Cria um novo URI de modelo e a coleção de parâmetros.

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

Cria um novo URI de modelo e a coleção de parâmetros.

BindByName(Uri, NameValueCollection, Boolean)

Cria um novo URI de modelo e a coleção de parâmetros.

BindByName(Uri, IDictionary<String,String>)

Cria um novo URI de modelo e a coleção de parâmetros.

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

Parâmetros

baseAddress
Uri

O endereço básico.

parameters
IDictionary<String,String>

Um dicionário que contém uma coleção de pares nome/valor do parâmetro.

Retornos

Uri

Um URI.

Comentários

O parâmetro IDictionary<string,string> contém uma coleção de pares de valor e nome de parâmetro. Os parâmetros são combinados com as variáveis dentro do modelo por uma comparação que não diferencia maiúsculas de minúsculas.

Observação

A coleção de nome/valor passada para esse método deve conter uma chave para cada variável de modelo. Pares de nome/valor extras que não correspondem a variáveis de modelo são acrescentados à cadeia de caracteres de consulta do URI final.

Importante

É possível passar o texto dentro dos pares nome/valor que impedem que o URI gerado corresponda ao modelo usado para gerá-lo. Exemplos desse texto incluem: '/', '..', '*', '{' e '}'.

Aplica-se a

BindByName(Uri, NameValueCollection)

Cria um novo URI de modelo e a coleção de parâmetros.

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

Parâmetros

baseAddress
Uri

O endereço básico.

parameters
NameValueCollection

Os valores de parâmetro.

Retornos

Uri

Uma nova instância.

Exemplos

O exemplo a seguir mostra como chamar o BindByName(Uri, NameValueCollection) método.

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)

Comentários

O NameValueCollection parâmetro contém uma coleção de pares nome/valor de parâmetro. Os parâmetros são combinados com as variáveis dentro do modelo por uma comparação que não diferencia maiúsculas de minúsculas. Os valores passados nesta coleção são escapados.

Observação

A coleção de nome/valor passada BindByName(Uri, NameValueCollection) deve conter uma chave para cada variável de modelo. Pares de nome/valor extras que não correspondem a variáveis de modelo são acrescentados à cadeia de caracteres de consulta do URI final.

Observação

É possível passar o texto dentro dos pares nome/valor que impedem que o URI gerado corresponda ao modelo usado para gerá-lo. Exemplos desse texto incluem: '/', '..', '*', '{' e '}'.

Aplica-se a

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

Cria um novo URI de modelo e a coleção de parâmetros.

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

Parâmetros

baseAddress
Uri

Um URI que contém o endereço básico.

parameters
IDictionary<String,String>

Um dicionário que contém uma coleção de pares nome/valor do parâmetro.

omitDefaults
Boolean

true se os valores padrão forem ignorados; caso contrário, false.

Retornos

Uri

Um URI.

Aplica-se a

BindByName(Uri, NameValueCollection, Boolean)

Cria um novo URI de modelo e a coleção de parâmetros.

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

Parâmetros

baseAddress
Uri

O endereço básico.

parameters
NameValueCollection

Uma coleção de pares nome/valor do parâmetro.

omitDefaults
Boolean

true se os valores padrão forem ignorados; caso contrário, false.

Retornos

Uri

Um URI.

Aplica-se a