UriTemplate.BindByName UriTemplate.BindByName UriTemplate.BindByName UriTemplate.BindByName Method

Definizione

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

Overload

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Parametri

baseAddress
Uri Uri Uri Uri

Indirizzo di base.The base address.

parameters
IDictionary<String,String>

Dizionario che contiene una raccolta di coppie nome/valore di parametro.A dictionary that contains a collection of parameter name/value pairs.

Restituisce

URI.A URI.

Commenti

Il IDictionary<stringa, stringa > parametro contiene una raccolta di coppie nome / valore di parametro.The IDictionary<string,string> parameter contains a collection of parameter name and value pairs. I parametri vengono confrontati con le variabili contenute nel modello. Questo confronto non fa distinzione fra maiuscole e minuscole.The parameters are matched up against the variables within the template by a case-insensitive comparison.

Nota

La raccolta delle coppie nome/valore passata a questo metodo deve contenere una chiave per ogni variabile del modello.The name/value collection passed to this method must contain a key for every template variable. Le coppie aggiuntive nome/valore che non corrispondono alle variabili del modello vengono aggiunte alla stringa di query dell'URI finale.Extra name/value pairs that do not match template variables are appended to the query string of the final URI.

Importante

Per evitare che l'URI generato corrisponda al modello utilizzato per generarlo è possibile passare elementi di testo all'interno delle coppie nome/valore.It is possible to pass in text within the name/value pairs that prevent the generated URI from matching the template that is used to generate it. Esempi di testo di questo tipo sono: '/', '..', '*', '{' e '}'.Examples of such text includes: '/', '..', '*', '{', and '}'.

BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection) BindByName(Uri, NameValueCollection)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Parametri

baseAddress
Uri Uri Uri Uri

Indirizzo di base.The base address.

parameters
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

Valori di parametro.The parameter values.

Restituisce

Una nuova istanza.A new instance.

Esempi

Nell'esempio seguente viene illustrato come chiamare il metodo BindByName(Uri, NameValueCollection).The following example shows how to call the BindByName(Uri, NameValueCollection) method.

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)

Commenti

Il parametro NameValueCollection contiene una raccolta di coppie nome/valore di parametro.The NameValueCollection parameter contains a collection of parameter name/value pairs. I parametri vengono confrontati con le variabili contenute nel modello. Questo confronto non fa distinzione fra maiuscole e minuscole.The parameters are matched up against the variables within the template by a case-insensitive comparison. I valori passati in questa raccolta sono preceduti da caratteri di escape.Values passed in this collection are escaped.

Nota

La raccolta delle coppie nome/valore passata al metodo BindByName(Uri, NameValueCollection) deve contenere una chiave per ogni variabile del modello.The name/value collection passed to BindByName(Uri, NameValueCollection) must contain a key for every template variable. Le coppie aggiuntive nome/valore che non corrispondono alle variabili del modello vengono aggiunte alla stringa di query dell'URI finale.Extra name/value pairs that do not match template variables are appended to the query string of the final URI.

Nota

Per evitare che l'URI generato corrisponda al modello utilizzato per generarlo è possibile passare elementi di testo all'interno delle coppie nome/valore.It is possible to pass in text within the name/value pairs that prevent the generated URI from matching the template that is used to generate it. Esempi di testo di questo tipo sono: '/', '..', '*', '{' e '}'.Examples of such text includes: '/', '..', '*', '{', and '}'.

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Parametri

baseAddress
Uri Uri Uri Uri

URI contenente l'indirizzo di base.A URI that contains the base address.

parameters
IDictionary<String,String>

Dizionario che contiene una raccolta di coppie nome/valore di parametro.A dictionary that contains a collection of parameter name/value pairs.

omitDefaults
Boolean Boolean Boolean Boolean

true se i valori predefiniti vengono ignorati. In caso contrario, false.true is the default values are ignored; otherwise false.

Restituisce

URI.A URI.

BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean) BindByName(Uri, NameValueCollection, Boolean)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.Creates a new URI from the template and the collection of parameters.

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

Parametri

baseAddress
Uri Uri Uri Uri

Indirizzo di base.The base address.

parameters
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

Raccolta di coppie nome/valore di parametro.A collection of parameter name/value pairs.

omitDefaults
Boolean Boolean Boolean Boolean

true se i valori predefiniti vengono ignorati; in caso contrario, false.true if the default values are ignored; otherwise false.

Restituisce

URI.A URI.

Si applica a