UriTemplate.BindByName Método

Definição

Espaço de Nomes:: System

Assemblagem:: System.ServiceModel.Web.dll

Assemblagens:: System.ServiceModel.dll, System.ServiceModel.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um novo URI a partir do template e da coleção de parâmetros.

Sobrecargas

Name	Description
BindByName(Uri, IDictionary<String,String>)	Cria um novo URI a partir do template e da coleção de parâmetros.
BindByName(Uri, NameValueCollection)	Cria um novo URI a partir do template e da coleção de parâmetros.
BindByName(Uri, IDictionary<String,String>, Boolean)	Cria um novo URI a partir do template e da coleção de parâmetros.
BindByName(Uri, NameValueCollection, Boolean)	Cria um novo URI a partir do template e da coleção de parâmetros.

BindByName(Uri, IDictionary<String,String>)

Cria um novo URI a partir do template e da 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

A morada da base.

parameters: IDictionary<String,String>

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

Devoluções

Uri

Um URI.

Observações

A cadeia IDictionary<, o parâmetro da cadeia> contém uma coleção de pares de nomes e valores dos parâmetros. Os parâmetros são comparados com as variáveis dentro do modelo através de uma comparação insensível a maiúsculas e minúsculas.

Note

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

Importante

É possível passar texto dentro dos pares nome/valor que impedem que o URI gerado coincida com o modelo usado para o gerar. Exemplos deste tipo de texto incluem: '/', '..', '*', '{' e '}'.

Aplica-se a

BindByName(Uri, NameValueCollection)

Cria um novo URI a partir do template e da 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

A morada da base.

parameters: NameValueCollection

Os valores dos parâmetros.

Devoluções

Uri

Uma nova instância.

Exemplos

O exemplo seguinte 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)

Observações

O NameValueCollection parâmetro contém uma coleção de pares nome/valor do parâmetro. Os parâmetros são comparados com as variáveis dentro do modelo através de uma comparação insensível a maiúsculas e minúsculas. Os valores passados nesta coleção são escapados.

Note

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

Note

É possível passar texto dentro dos pares nome/valor que impedem que o URI gerado coincida com o modelo usado para o gerar. Exemplos deste tipo de texto incluem: '/', '..', '*', '{' e '}'.

Aplica-se a

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

Cria um novo URI a partir do template e da 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 base.

parameters: IDictionary<String,String>

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

omitDefaults: Boolean

true é que os valores padrão são ignorados; caso contrário false.

Devoluções

Uri

Um URI.

Aplica-se a

BindByName(Uri, NameValueCollection, Boolean)

Cria um novo URI a partir do template e da 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

A morada da base.

parameters: NameValueCollection

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

omitDefaults: Boolean

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

Devoluções

Uri

Um URI.

Aplica-se a

Comentários

Esta página foi útil?