UriTemplate.BindByName Metoda

Definice

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

Přetížení

BindByName(Uri, IDictionary<String,String>)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

BindByName(Uri, NameValueCollection)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

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

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

BindByName(Uri, NameValueCollection, Boolean)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

BindByName(Uri, IDictionary<String,String>)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

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

Parametry

baseAddress
Uri

Základní adresa.

parameters
IDictionary<String,String>

Slovník, který obsahuje kolekci párů název/hodnota parametru.

Návraty

Uri

Identifikátor URI.

Poznámky

Parametr IDictionary<string,string> obsahuje kolekci párů názvů parametrů a hodnot. Parametry se shodují s proměnnými v šabloně porovnáním nerozlišujícími velká a malá písmena.

Poznámka

Kolekce name/value předaná této metodě musí obsahovat klíč pro každou proměnnou šablony. Páry extra name/value, které neodpovídají proměnným šablony, se připojují k řetězci dotazu konečného identifikátoru URI.

Důležité

V párech názvů a hodnot je možné předat text, který brání vygenerovanému identifikátoru URI v porovnání se šablonou použitou k vygenerování. Mezi příklady takového textu patří: /, .., *, {a}.

Platí pro

BindByName(Uri, NameValueCollection)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

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

Parametry

baseAddress
Uri

Základní adresa.

parameters
NameValueCollection

Hodnoty parametrů.

Návraty

Uri

Nová instance.

Příklady

Následující příklad ukazuje, jak volat metodu 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)

Poznámky

Parametr NameValueCollection obsahuje kolekci párů název/hodnota parametru. Parametry se shodují s proměnnými v šabloně porovnáním nerozlišujícími velká a malá písmena. Hodnoty předané v této kolekci jsou řídicí.

Poznámka

Kolekce name/value předaná BindByName(Uri, NameValueCollection) musí obsahovat klíč pro každou proměnnou šablony. Páry extra name/value, které neodpovídají proměnným šablony, se připojují k řetězci dotazu konečného identifikátoru URI.

Poznámka

V párech názvů a hodnot je možné předat text, který brání vygenerovanému identifikátoru URI v porovnání se šablonou použitou k vygenerování. Mezi příklady takového textu patří: /, .., *, {a}.

Platí pro

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

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

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

Parametry

baseAddress
Uri

Identifikátor URI, který obsahuje základní adresu.

parameters
IDictionary<String,String>

Slovník, který obsahuje kolekci párů název/hodnota parametru.

omitDefaults
Boolean

true je výchozí hodnoty ignorovány; jinak false.

Návraty

Uri

Identifikátor URI.

Platí pro

BindByName(Uri, NameValueCollection, Boolean)

Vytvoří nový identifikátor URI ze šablony a kolekce parametrů.

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

Parametry

baseAddress
Uri

Základní adresa.

parameters
NameValueCollection

Kolekce párů název/hodnota parametru.

omitDefaults
Boolean

true pokud jsou výchozí hodnoty ignorovány; jinak false.

Návraty

Uri

Identifikátor URI.

Platí pro