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
| Nom | Description |
|---|---|
| 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/valeur de paramètre.
Retours
A URI.
Remarques
La chaîne IDictionary<, paramètre de chaîne> contient une collection de paires nom et valeur de paramètre. Les paramètres sont mis en correspondance avec les variables dans le modèle par une comparaison qui ne respecte pas la casse.
Note
La collection nom/valeur passée à cette méthode doit contenir une clé pour chaque variable de modèle. Des 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 transmettre du texte dans les paires nom/valeur qui empêchent l’URI généré de correspondre au modèle utilisé pour le générer. Par exemple, ce texte comprend : '/', '..', '*', '{' 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 des paramètres.
Retours
Nouvelle instance.
Exemples
L’exemple suivant montre comment appeler la BindByName(Uri, NameValueCollection) méthode .
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 NameValueCollection paramètre contient une collection de paires nom/valeur de paramètre. Les paramètres sont mis en correspondance avec les variables dans le modèle par une comparaison qui ne respecte pas la casse. Les valeurs passées dans cette collection sont échappées.
Note
La collection nom/valeur passée BindByName(Uri, NameValueCollection) doit contenir une clé pour chaque variable de modèle. Des 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.
Note
Il est possible de transmettre du texte dans les paires nom/valeur qui empêchent l’URI généré de correspondre au modèle utilisé pour le générer. Par exemple, ce texte comprend : '/', '..', '*', '{' 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/valeur de paramètre.
- omitDefaults
- Boolean
true est les valeurs par défaut ignorées ; sinon false.
Retours
A 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/valeur de paramètre.
- omitDefaults
- Boolean
true si les valeurs par défaut sont ignorées ; sinon false.
Retours
A URI.