UriTemplate.BindByName Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un nuevo URI a partir de la plantilla y la colección de parámetros.
Sobrecargas
| Nombre | Description |
|---|---|
| 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 nombre-valor de parámetro.
Devoluciones
Un URI.
Comentarios
El parámetro de cadena IDictionary<> contiene una colección de pares de nombre de parámetro y valor. Los parámetros se comparan con las variables de la plantilla mediante una comparación sin distinción entre mayúsculas y minúsculas.
Note
La colección name/value que se pasa a este método debe contener una clave para cada variable de plantilla. Los pares de nombre y valor adicionales que no coinciden con variables de plantilla se anexan a la cadena de consulta del URI final.
Importante
Es posible pasar texto dentro de los pares nombre-valor que impiden que el URI generado coincida con la plantilla que se usa para generarlo. Algunos ejemplos de este texto incluyen: '/', '..', '*', '{' y '}'.
Se aplica a
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
Nueva instancia.
Ejemplos
En el ejemplo siguiente se muestra cómo llamar al 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)
Comentarios
El NameValueCollection parámetro contiene una colección de pares nombre-valor de parámetro. Los parámetros se comparan con las variables de la plantilla mediante una comparación sin distinción entre mayúsculas y minúsculas. Los valores pasados en esta colección son de escape.
Note
La colección name/value pasada a BindByName(Uri, NameValueCollection) debe contener una clave para cada variable de plantilla. Los pares de nombre y valor adicionales que no coinciden con variables de plantilla se anexan a la cadena de consulta del URI final.
Note
Es posible pasar texto dentro de los pares nombre-valor que impiden que el URI generado coincida con la plantilla que se usa para generarlo. Algunos ejemplos de este texto incluyen: '/', '..', '*', '{' y '}'.
Se aplica a
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 nombre-valor de parámetro.
- omitDefaults
- Boolean
true es el valor predeterminado que se omite; de lo contrario false, es .
Devoluciones
Un URI.
Se aplica a
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 nombre-valor de parámetro.
- omitDefaults
- Boolean
true si se omiten los valores predeterminados; de lo contrario false, es .
Devoluciones
Un URI.