UriTemplate.BindByName Methode

Definition

Namespace:
System
Assembly:
System.ServiceModel.Web.dll
Assemblys:
System.ServiceModel.dll, System.ServiceModel.Web.dll

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

Überlädt

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

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.
BindByName(Uri, NameValueCollection)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.
BindByName(Uri, IDictionary<String,String>, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.
BindByName(Uri, NameValueCollection, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

BindByName(Uri, IDictionary<String,String>)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

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 Sammlung von Parameternamen-Wert-Paaren enthält.

Gibt zurück

Uri

Ein URI.

Hinweise

Der Parameter "IDictionary<string,string> " enthält eine Sammlung von Parameternamen- und Wertpaaren. Die Parameter werden anhand eines Vergleichs zwischen Groß- und Kleinschreibung mit den Variablen innerhalb der Vorlage abgeglichen.

Note

Die an diese Methode übergebene Name/Wertauflistung 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.

Important

Es ist möglich, Text innerhalb der Namen/Wert-Paare zu übergeben, die verhindern, dass der generierte URI mit der Vorlage übereinstimmt, die zum Generieren verwendet wird. Beispiele für diesen Text sind: '/', '..', '*', '{' und '}'.

Gilt für:

BindByName(Uri, NameValueCollection)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

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 gezeigt, wie die BindByName(Uri, NameValueCollection) -Methode aufgerufen wird.

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 Auflistung von Parameternamen-Wert-Paaren. Die Parameter werden anhand eines Vergleichs zwischen Groß- und Kleinschreibung mit den Variablen innerhalb der Vorlage abgeglichen. In dieser Auflistung übergebene Werte werden mit Escapezeichen versehen.

Note

Die übergebene BindByName(Uri, NameValueCollection) Name/Wertauflistung 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.

Note

Es ist möglich, Text innerhalb der Namen/Wert-Paare zu übergeben, die verhindern, dass der generierte URI mit der Vorlage übereinstimmt, die zum Generieren verwendet wird. Beispiele für diesen Text sind: '/', '..', '*', '{' und '}'.

Gilt für:

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

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

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 Sammlung von Parameternamen-Wert-Paaren enthält.

omitDefaults
Boolean

true ist die Standardwerte ignoriert; andernfalls false.

Gibt zurück

Uri

Ein URI.

Gilt für:

BindByName(Uri, NameValueCollection, Boolean)

Erstellt einen neuen URI aus der Vorlage und der Sammlung von Parametern.

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 Sammlung von Parameternamen-Wert-Paaren.

omitDefaults
Boolean

true wenn die Standardwerte ignoriert werden; andernfalls false.

Gibt zurück

Uri

Ein URI.

Gilt für: