UriTemplate.BindByName Methode

Definition

Namespace:

System

Assembly:

System.ServiceModel.Web.dll

Assembly:

System.ServiceModel.dll

Assemblys:

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

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

Überlädt

BindByName(Uri, IDictionary<String,String>)	Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.
BindByName(Uri, NameValueCollection)	Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.
BindByName(Uri, IDictionary<String,String>, Boolean)	Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.
BindByName(Uri, NameValueCollection, Boolean)	Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

BindByName(Uri, IDictionary<String,String>)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

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

Parameter

baseAddress

Uri

Die Basisadresse.

parameters

IDictionary<String,String>

Ein Wörterbuch, das eine Parameterauflistung von Name-Wert-Paaren enthält.

Gibt zurück

Uri

Ein URI.

Hinweise

Der Parameter "IDictionary<string,string> " enthält eine Auflistung von Parameternamen- und Wertpaaren. Die Parameter werden durch einen Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung mit den Variablen in der Vorlage abgeglichen.

Hinweis

Die an diese Methode übergebene Name-Wert-Auflistung muss einen Schlüssel für jede Vorlagenvariable enthalten. Zusätzliche Name-Wert-Paare, die nicht mit Vorlagenvariablen übereinstimmen, werden an die Abfragezeichenfolge des endgültigen URI angefügt.

Wichtig

Es ist möglich, Text innerhalb der Name-Wert-Paare zu übergeben, durch den verhindert wird, dass der generierte URI mit der Vorlage übereinstimmt, mit der er generiert wird. Beispiele hierfür sind "/", "..", "*", "{"' und "}".

BindByName(Uri, NameValueCollection)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

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

Parameter

baseAddress

Uri

Die Basisadresse.

parameters

NameValueCollection

Die Parameterwerte.

Gibt zurück

Uri

Eine neue -Instanz.

Beispiele

Im folgenden Beispiel wird der Aufruf der BindByName(Uri, NameValueCollection)-Methode veranschaulicht.

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)

Hinweise

Der NameValueCollection-Parameter enthält eine Parameterauflistung von Name/Wert-Paaren. Die Parameter werden durch einen Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung mit den Variablen in der Vorlage abgeglichen. In dieser Auflistung übergebene Werte werden mit Escapezeichen versehen.

Hinweis

Die an BindByName(Uri, NameValueCollection) übergebene Name-Wert-Auflistung muss einen Schlüssel für jede Vorlagenvariable enthalten. Zusätzliche Name-Wert-Paare, die nicht mit Vorlagenvariablen übereinstimmen, werden an die Abfragezeichenfolge des endgültigen URI angefügt.

Hinweis

Es ist möglich, Text innerhalb der Name-Wert-Paare zu übergeben, durch den verhindert wird, dass der generierte URI mit der Vorlage übereinstimmt, mit der er generiert wird. Beispiele hierfür sind "/", "..", "*", "{"' und "}".

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

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

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

Parameter

baseAddress

Uri

Ein URI, der die Basisadresse enthält.

parameters

IDictionary<String,String>

Ein Wörterbuch, das eine Parameterauflistung von Name-Wert-Paaren enthält.

omitDefaults

Boolean

true, wenn die Standardwerte ignoriert werden, andernfalls false.

Gibt zurück

Uri

Ein URI.

BindByName(Uri, NameValueCollection, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Parameterauflistung.

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

Parameter

baseAddress

Uri

Die Basisadresse.

parameters

NameValueCollection

Eine Paramterauflistung mit Name-Wert-Paaren.

omitDefaults

Boolean

true, wenn die Standardwerte ignoriert werden, andernfalls false.

Gibt zurück

Uri

Ein URI.