UriTemplate.BindByName Méthode

Définition

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

Uri

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

Uri

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

Uri

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

Uri

A URI.

S’applique à