Partager via


UriTemplate.BindByName Méthode

Définition

Crée un URI à partir du modèle et de la collection de paramètres.

Surcharges

BindByName(Uri, IDictionary<String,String>)

Crée un URI à partir du modèle et de la collection de paramètres.

BindByName(Uri, NameValueCollection)

Crée un URI à partir du modèle et de la collection de paramètres.

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

Crée un URI à partir du modèle et de la collection de paramètres.

BindByName(Uri, NameValueCollection, Boolean)

Crée un URI à partir du modèle et de la collection de paramètres.

BindByName(Uri, IDictionary<String,String>)

Crée un URI à partir du modèle et de la collection de paramètres.

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

Paramètres

baseAddress
Uri

Adresse de base.

parameters
IDictionary<String,String>

Dictionnaire qui contient une collection de paires nom de paramètre/valeur.

Retours

Uri

URI.

Remarques

Le paramètre IDictionary<string,string> contient une collection de paires nom et valeur de paramètre. Les paramètres sont mis en correspondance par rapport aux variables du modèle, sur la base d'une comparaison qui ne respecte pas la casse.

Notes

La collection nom/valeur passée à cette méthode doit contenir une clé pour chaque variable de modèle. Les paires nom/valeur supplémentaires qui ne correspondent pas aux variables de modèle sont ajoutées à la chaîne de requête de l'URI final.

Important

Il est possible de passer du texte dans les paires nom/valeur qui empêchent l'URI généré de correspondre au modèle utilisé pour sa génération. Les exemples de ce type de texte sont les suivants : '/', '..', '*', '{', et '}'.

S’applique à

BindByName(Uri, NameValueCollection)

Crée un URI à partir du modèle et de la collection de paramètres.

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

Paramètres

baseAddress
Uri

Adresse de base.

parameters
NameValueCollection

Valeurs de paramètres.

Retours

Uri

Nouvelle instance.

Exemples

L'exemple suivant montre comment appeler la méthode 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)

Remarques

Le paramètre NameValueCollection contient une collection de paires nom de paramètre/valeur. Les paramètres sont mis en correspondance par rapport aux variables du modèle, sur la base d'une comparaison qui ne respecte pas la casse. Les valeurs passées dans cette collection sont placées dans une séquence d’échappement.

Notes

La collection nom/valeur transmise à BindByName(Uri, NameValueCollection) doit contenir une clé pour chaque variable de modèle. Les paires nom/valeur supplémentaires qui ne correspondent pas aux variables de modèle sont ajoutées à la chaîne de requête de l'URI final.

Notes

Il est possible de passer du texte dans les paires nom/valeur qui empêchent l'URI généré de correspondre au modèle utilisé pour sa génération. Les exemples de ce type de texte sont les suivants : '/', '..', '*', '{', et '}'.

S’applique à

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

Crée un URI à partir du modèle et de la collection de paramètres.

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

Paramètres

baseAddress
Uri

URI qui contient l'adresse de base.

parameters
IDictionary<String,String>

Dictionnaire qui contient une collection de paires nom de paramètre/valeur.

omitDefaults
Boolean

true si les valeurs par défaut sont ignorées ; sinon false.

Retours

Uri

URI.

S’applique à

BindByName(Uri, NameValueCollection, Boolean)

Crée un URI à partir du modèle et de la collection de paramètres.

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

Paramètres

baseAddress
Uri

Adresse de base.

parameters
NameValueCollection

Collection de paires nom de paramètre/valeur.

omitDefaults
Boolean

true si les valeurs par défaut sont ignorées ; sinon false.

Retours

Uri

URI.

S’applique à