Nyelv

UriTemplate.BindByName Metódus

Definíció

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

Túlterhelések

Name Description
BindByName(Uri, IDictionary<String,String>)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

BindByName(Uri, NameValueCollection)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

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

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

BindByName(Uri, NameValueCollection, Boolean)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

BindByName(Uri, IDictionary<String,String>)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

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éterek

baseAddress
Uri

Az alapcím.

parameters
IDictionary<String,String>

Egy szótár, amely a paraméternév/érték párok gyűjteményét tartalmazza.

Válaszok

Uri

Egy URI.

Megjegyzések

Az IDictionary sztring<paraméter> paraméternév- és értékpárok gyűjteményét tartalmazza. A paraméterek a sablonban lévő változókkal egy kis- és nagybetűk érzéketlen összehasonlításával vannak egyeztetve.

Note

A metódusnak átadott név-érték gyűjteménynek tartalmaznia kell minden sablonváltozó kulcsát. A sablonváltozókkal nem egyező extra név-érték párok hozzá lesznek fűzve a végső URI lekérdezési sztringjéhez.

Important

A név-érték párokon belül olyan szöveget is átadhat, amely megakadályozza, hogy a létrehozott URI megegyezzék a létrehozásához használt sablonnal. Ilyen szöveg például a következő: "/", "..", "*", "{" és "}".

A következőre érvényes:

BindByName(Uri, NameValueCollection)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

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éterek

baseAddress
Uri

Az alapcím.

parameters
NameValueCollection

A paraméterértékek.

Válaszok

Uri

Új példány.

Példák

Az alábbi példa bemutatja, hogyan hívhatja meg a metódust 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)

Megjegyzések

A NameValueCollection paraméter a paraméternév/érték párok gyűjteményét tartalmazza. A paraméterek a sablonban lévő változókkal egy kis- és nagybetűk érzéketlen összehasonlításával vannak egyeztetve. Az ebben a gyűjteményben átadott értékek nem lesznek elérhetők.

Note

Az átadott név-érték gyűjteménynek BindByName(Uri, NameValueCollection) tartalmaznia kell egy kulcsot minden sablonváltozóhoz. A sablonváltozókkal nem egyező extra név-érték párok hozzá lesznek fűzve a végső URI lekérdezési sztringjéhez.

Note

A név-érték párokon belül olyan szöveget is átadhat, amely megakadályozza, hogy a létrehozott URI megegyezzék a létrehozásához használt sablonnal. Ilyen szöveg például a következő: "/", "..", "*", "{" és "}".

A következőre érvényes:

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

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

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éterek

baseAddress
Uri

Az alapcímet tartalmazó URI.

parameters
IDictionary<String,String>

Egy szótár, amely a paraméternév/érték párok gyűjteményét tartalmazza.

omitDefaults
Boolean

true az alapértelmezett értékek figyelmen kívül hagyása; egyéb esetben false.

Válaszok

Uri

Egy URI.

A következőre érvényes:

BindByName(Uri, NameValueCollection, Boolean)

Létrehoz egy új URI-t a sablonból és a paraméterek gyűjteményéből.

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éterek

baseAddress
Uri

Az alapcím.

parameters
NameValueCollection

Paraméternév-/értékpárok gyűjteménye.

omitDefaults
Boolean

true ha az alapértelmezett értékeket figyelmen kívül hagyja; egyéb esetben false.

Válaszok

Uri

Egy URI.

A következőre érvényes: