Freigeben über


UriTemplate.BindByName Methode

Definition

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 "}".

Gilt für

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 "}".

Gilt für

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.

Gilt für

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.

Gilt für