UriTemplate.BindByName Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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
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.
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.