Condividi tramite


UriTemplate.BindByName Metodo

Definizione

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

Overload

BindByName(Uri, IDictionary<String,String>)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

BindByName(Uri, NameValueCollection)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

BindByName(Uri, NameValueCollection, Boolean)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

BindByName(Uri, IDictionary<String,String>)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

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

Indirizzo di base.

parameters
IDictionary<String,String>

Dizionario che contiene una raccolta di coppie nome/valore di parametro.

Restituisce

Uri

URI.

Commenti

Il parametro IDictionary<string,string> contiene una raccolta di coppie nome parametro e valore. I parametri vengono confrontati con le variabili contenute nel modello. Questo confronto non fa distinzione fra maiuscole e minuscole.

Nota

La raccolta delle coppie nome/valore passata a questo metodo deve contenere una chiave per ogni variabile del modello. Le coppie aggiuntive nome/valore che non corrispondono alle variabili del modello vengono aggiunte alla stringa di query dell'URI finale.

Importante

Per evitare che l'URI generato corrisponda al modello utilizzato per generarlo è possibile passare elementi di testo all'interno delle coppie nome/valore. Esempi di testo di questo tipo sono: '/', '..', '*', '{' e '}'.

Si applica a

BindByName(Uri, NameValueCollection)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

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

Indirizzo di base.

parameters
NameValueCollection

Valori di parametro.

Restituisce

Uri

Una nuova istanza.

Esempio

Nell'esempio seguente viene illustrato come chiamare il metodo 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)

Commenti

Il parametro NameValueCollection contiene una raccolta di coppie nome/valore di parametro. I parametri vengono confrontati con le variabili contenute nel modello. Questo confronto non fa distinzione fra maiuscole e minuscole. I valori passati in questa raccolta sono preceduti da caratteri di escape.

Nota

La raccolta delle coppie nome/valore passata al metodo BindByName(Uri, NameValueCollection) deve contenere una chiave per ogni variabile del modello. Le coppie aggiuntive nome/valore che non corrispondono alle variabili del modello vengono aggiunte alla stringa di query dell'URI finale.

Nota

Per evitare che l'URI generato corrisponda al modello utilizzato per generarlo è possibile passare elementi di testo all'interno delle coppie nome/valore. Esempi di testo di questo tipo sono: '/', '..', '*', '{' e '}'.

Si applica a

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

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

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 contenente l'indirizzo di base.

parameters
IDictionary<String,String>

Dizionario che contiene una raccolta di coppie nome/valore di parametro.

omitDefaults
Boolean

true se i valori predefiniti vengono ignorati. In caso contrario, false.

Restituisce

Uri

URI.

Si applica a

BindByName(Uri, NameValueCollection, Boolean)

Crea un nuovo URI a partire dal modello e dalla raccolta di parametri.

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

Indirizzo di base.

parameters
NameValueCollection

Raccolta di coppie nome/valore di parametro.

omitDefaults
Boolean

true se i valori predefiniti vengono ignorati. In caso contrario, false.

Restituisce

Uri

URI.

Si applica a