UriTemplate.BindByName Methode

Definitie

Naamruimte:

System

Assembly's:

System.ServiceModel.dll, System.ServiceModel.Web.dll

Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

Overloads

Name	Description
BindByName(Uri, IDictionary<String,String>)	Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.
BindByName(Uri, NameValueCollection)	Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.
BindByName(Uri, IDictionary<String,String>, Boolean)	Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.
BindByName(Uri, NameValueCollection, Boolean)	Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

BindByName(Uri, IDictionary<String,String>)

Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

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

Parameters

baseAddress

Uri

Het basisadres.

parameters

IDictionary<String,String>

Een woordenlijst die een verzameling parameternaam/waardeparen bevat.

Retouren

Uri

Een URI.

Opmerkingen

De IDictionary-tekenreeks<, tekenreeksparameter> bevat een verzameling parameternaam- en waardeparen. De parameters worden vergeleken met de variabelen in de sjabloon door een niet-hoofdlettergevoelige vergelijking.

Note

De verzameling naam/waarde die aan deze methode wordt doorgegeven, moet een sleutel bevatten voor elke sjabloonvariabele. Extra naam-/waardeparen die niet overeenkomen met sjabloonvariabelen, worden toegevoegd aan de querytekenreeks van de uiteindelijke URI.

Important

Het is mogelijk om tekst door te geven binnen de naam-/waardeparen die verhinderen dat de gegenereerde URI overeenkomt met de sjabloon die wordt gebruikt om deze te genereren. Voorbeelden van dergelijke tekst zijn: '/', '..', '*', '{' en '}'.

BindByName(Uri, NameValueCollection)

Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

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

Parameters

baseAddress

Uri

Het basisadres.

parameters

NameValueCollection

De parameterwaarden.

Retouren

Uri

Een nieuw exemplaar.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de BindByName(Uri, NameValueCollection) methode aanroept.

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)

Opmerkingen

De NameValueCollection parameter bevat een verzameling parameternaam/waardeparen. De parameters worden vergeleken met de variabelen in de sjabloon door een niet-hoofdlettergevoelige vergelijking. Waarden die in deze verzameling worden doorgegeven, worden ontsnapt.

Note

De doorgegeven BindByName(Uri, NameValueCollection) naam/waardeverzameling moet een sleutel bevatten voor elke sjabloonvariabele. Extra naam-/waardeparen die niet overeenkomen met sjabloonvariabelen, worden toegevoegd aan de querytekenreeks van de uiteindelijke URI.

Note

Het is mogelijk om tekst door te geven binnen de naam-/waardeparen die verhinderen dat de gegenereerde URI overeenkomt met de sjabloon die wordt gebruikt om deze te genereren. Voorbeelden van dergelijke tekst zijn: '/', '..', '*', '{' en '}'.

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

Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

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

Parameters

baseAddress

Uri

Een URI die het basisadres bevat.

parameters

IDictionary<String,String>

Een woordenlijst die een verzameling parameternaam/waardeparen bevat.

omitDefaults

Boolean

true is dat de standaardwaarden worden genegeerd; anders false.

Retouren

Uri

Een URI.

BindByName(Uri, NameValueCollection, Boolean)

Hiermee maakt u een nieuwe URI op basis van de sjabloon en de verzameling parameters.

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

Parameters

baseAddress

Uri

Het basisadres.

parameters

NameValueCollection

Een verzameling parameternaam-/waardeparen.

omitDefaults

Boolean

true als de standaardwaarden worden genegeerd; anders false.

Retouren

Uri

Een URI.