UriTemplate.BindByName Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.ServiceModel.Web.dll

Zestaw:

System.ServiceModel.dll

Zestawy:

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

Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

Przeciążenia

BindByName(Uri, IDictionary<String,String>)	Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.
BindByName(Uri, NameValueCollection)	Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.
BindByName(Uri, IDictionary<String,String>, Boolean)	Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.
BindByName(Uri, NameValueCollection, Boolean)	Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

BindByName(Uri, IDictionary<String,String>)

Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

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

Parametry

baseAddress

Uri

Adres podstawowy.

parameters

IDictionary<String,String>

Słownik zawierający kolekcję par nazw/wartości parametrów.

Zwraca

Uri

Identyfikator URI.

Uwagi

Parametr IDictionary<string,string> zawiera kolekcję par nazw parametrów i wartości. Parametry są dopasowywane do zmiennych w szablonie przez porównanie bez uwzględniania wielkości liter.

Uwaga

Kolekcja nazw/wartości przekazana do tej metody musi zawierać klucz dla każdej zmiennej szablonu. Dodatkowe pary nazw/wartości, które nie pasują do zmiennych szablonu, są dołączane do ciągu zapytania końcowego identyfikatora URI.

Ważne

Istnieje możliwość przekazania tekstu w parach nazw/wartości, które uniemożliwiają wygenerowanie wygenerowanego identyfikatora URI pasującego do szablonu używanego do jego wygenerowania. Przykłady takiego tekstu obejmują: "/", "."., "*", "{" i "}".

BindByName(Uri, NameValueCollection)

Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

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

Parametry

baseAddress

Uri

Adres podstawowy.

parameters

NameValueCollection

Wartości parametrów.

Zwraca

Uri

Nowe wystąpienie.

Przykłady

W poniższym przykładzie pokazano, jak wywołać metodę 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)

Uwagi

Parametr NameValueCollection zawiera kolekcję par nazwa/wartość parametru. Parametry są dopasowywane do zmiennych w szablonie przez porównanie bez uwzględniania wielkości liter. Wartości przekazane w tej kolekcji są ucieczki.

Uwaga

Przekazana kolekcja BindByName(Uri, NameValueCollection) nazw/wartości musi zawierać klucz dla każdej zmiennej szablonu. Dodatkowe pary nazw/wartości, które nie pasują do zmiennych szablonu, są dołączane do ciągu zapytania końcowego identyfikatora URI.

Uwaga

Istnieje możliwość przekazania tekstu w parach nazw/wartości, które uniemożliwiają wygenerowanie wygenerowanego identyfikatora URI pasującego do szablonu używanego do jego wygenerowania. Przykłady takiego tekstu obejmują: "/", "."., "*", "{" i "}".

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

Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

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

Parametry

baseAddress

Uri

Identyfikator URI zawierający adres podstawowy.

parameters

IDictionary<String,String>

Słownik zawierający kolekcję par nazw/wartości parametrów.

omitDefaults

Boolean

true to wartości domyślne są ignorowane; w przeciwnym razie false.

Zwraca

Uri

Identyfikator URI.

BindByName(Uri, NameValueCollection, Boolean)

Tworzy nowy identyfikator URI na podstawie szablonu i kolekcji parametrów.

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

Parametry

baseAddress

Uri

Adres podstawowy.

parameters

NameValueCollection

Kolekcja par nazwa/wartość parametru.

omitDefaults

Boolean

true jeśli wartości domyślne są ignorowane; w przeciwnym razie false.

Zwraca

Uri

Identyfikator URI.