UriTemplate.BindByName Método

Definición

Espacio de nombres:

System

Ensamblado:

System.ServiceModel.Web.dll

Ensamblado:

System.ServiceModel.dll

Ensamblados:

System.ServiceModel.dll, System.ServiceModel.Web.dll

Crea un nuevo URI a partir de la plantilla y la colección de parámetros.

Sobrecargas

BindByName(Uri, IDictionary<String,String>)	Crea un nuevo URI a partir de la plantilla y la colección de parámetros.
BindByName(Uri, NameValueCollection)	Crea un nuevo URI a partir de la plantilla y la colección de parámetros.
BindByName(Uri, IDictionary<String,String>, Boolean)	Crea un nuevo URI a partir de la plantilla y la colección de parámetros.
BindByName(Uri, NameValueCollection, Boolean)	Crea un nuevo URI a partir de la plantilla y la colección de parámetros.

BindByName(Uri, IDictionary<String,String>)

Crea un nuevo URI a partir de la plantilla y la colección 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

Dirección base.

parameters

IDictionary<String,String>

Diccionario que contiene una colección de pares de nombre-valor de parámetros.

Devoluciones

Uri

Identificador URI.

Comentarios

El parámetro IDictionary<string,string> contiene una colección de pares nombre de parámetro y valor. Los parámetros se hacen coincidir con las variables dentro de la plantilla por una comparación sin distinción entre mayúsculas y minúsculas.

Nota

La colección de nombre/valor pasada a este método debe contener una clave para cada variable de plantilla. Los pares de nombre-valor adicionales que no coinciden con variables de plantilla se anexan a la cadena de consulta del último URI.

Importante

Es posible pasar texto dentro de los pares de nombre-valor que evitarán que el URI generado coincida con la plantilla que se utiliza para generarlo. Son ejemplos de ese texto: '/', '..', '*', '{', y '}'.

BindByName(Uri, NameValueCollection)

Crea un nuevo URI a partir de la plantilla y la colección 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

Dirección base.

parameters

NameValueCollection

Valores de parámetro.

Devoluciones

Uri

Nueva instancia.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al método 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)

Comentarios

El parámetro NameValueCollection contiene una colección de pares de nombre-valor de parámetro. Los parámetros se hacen coincidir con las variables dentro de la plantilla por una comparación sin distinción entre mayúsculas y minúsculas. Se escapan los valores pasados en esta colección.

Nota

La colección de nombre/valor pasada a BindByName(Uri, NameValueCollection) debe contener una clave para cada variable de plantilla. Los pares de nombre-valor adicionales que no coinciden con variables de plantilla se anexan a la cadena de consulta del último URI.

Nota

Es posible pasar texto dentro de los pares de nombre-valor que evitarán que el URI generado coincida con la plantilla que se utiliza para generarlo. Son ejemplos de ese texto: '/', '..', '*', '{', y '}'.

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

Crea un nuevo URI a partir de la plantilla y la colección 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

URI que contiene la dirección base.

parameters

IDictionary<String,String>

Diccionario que contiene una colección de pares de nombre-valor de parámetros.

omitDefaults

Boolean

true si los valores predeterminados se ignoran; de lo contrario, false.

Devoluciones

Uri

Identificador URI.

BindByName(Uri, NameValueCollection, Boolean)

Crea un nuevo URI a partir de la plantilla y la colección 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

Dirección base.

parameters

NameValueCollection

Colección de pares de nombre-valor de parámetros.

omitDefaults

Boolean

true si los valores predeterminados se ignoran; de lo contrario, false.

Devoluciones

Uri

Identificador URI.