UriTemplate.BindByName Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.ServiceModel.Web.dll

Assembly:

System.ServiceModel.dll

Assembly:

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

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 '}'.

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 '}'.

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.

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.