UriTemplate.BindByName Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
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
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
Identifikátor URI.