UriTemplate.BindByName メソッド

定義

名前空間:
System
アセンブリ:
System.ServiceModel.Web.dll
アセンブリ:
System.ServiceModel.dll, System.ServiceModel.Web.dll

テンプレートとパラメーターのコレクションから新しい URI を作成します。

オーバーロード

名前 説明
BindByName(Uri, IDictionary<String,String>)

テンプレートとパラメーターのコレクションから新しい URI を作成します。
BindByName(Uri, NameValueCollection)

テンプレートとパラメーターのコレクションから新しい URI を作成します。
BindByName(Uri, IDictionary<String,String>, Boolean)

テンプレートとパラメーターのコレクションから新しい URI を作成します。
BindByName(Uri, NameValueCollection, Boolean)

テンプレートとパラメーターのコレクションから新しい URI を作成します。

BindByName(Uri, IDictionary<String,String>)

テンプレートとパラメーターのコレクションから新しい URI を作成します。

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

パラメーター

baseAddress
Uri

ベース アドレス。

parameters
IDictionary<String,String>

パラメーターの名前と値のペアのコレクションを含むディクショナリ。

返品

Uri

URI。

注釈

IDictionary<string,string> パラメーターには、パラメーター名と値のペアのコレクションが含まれています。 パラメーターは、大文字と小文字を区別しない比較によって、テンプレート内の変数と照合されます。

Note

このメソッドに渡される名前/値コレクションには、すべてのテンプレート変数のキーが含まれている必要があります。 テンプレート変数と一致しない追加の名前と値のペアは、最終的な URI のクエリ文字列に追加されます。

Important

生成された URI が、生成に使用されるテンプレートと一致しないように、名前と値のペア内のテキストを渡すことができます。 このようなテキストの例には、'/'、'..'、'*'、'{'、'}' があります。

適用対象

BindByName(Uri, NameValueCollection)

テンプレートとパラメーターのコレクションから新しい URI を作成します。

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

パラメーター

baseAddress
Uri

ベース アドレス。

parameters
NameValueCollection

パラメーター値。

返品

Uri

新しいインスタンス。

例

次の例では、 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)

注釈

NameValueCollection パラメーターには、パラメーターの名前と値のペアのコレクションが含まれています。 パラメーターは、大文字と小文字を区別しない比較によって、テンプレート内の変数と照合されます。 このコレクションで渡された値はエスケープされます。

Note

BindByName(Uri, NameValueCollection)に渡される名前/値コレクションには、すべてのテンプレート変数のキーが含まれている必要があります。 テンプレート変数と一致しない追加の名前と値のペアは、最終的な URI のクエリ文字列に追加されます。

Note

生成された URI が、生成に使用されるテンプレートと一致しないように、名前と値のペア内のテキストを渡すことができます。 このようなテキストの例には、'/'、'..'、'*'、'{'、'}' があります。

適用対象

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

テンプレートとパラメーターのコレクションから新しい URI を作成します。

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

パラメーター

baseAddress
Uri

ベース アドレスを含む URI。

parameters
IDictionary<String,String>

パラメーターの名前と値のペアのコレクションを含むディクショナリ。

omitDefaults
Boolean

true は既定値は無視されます。それ以外の場合は false。

返品

Uri

URI。

適用対象

BindByName(Uri, NameValueCollection, Boolean)

テンプレートとパラメーターのコレクションから新しい URI を作成します。

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

パラメーター

baseAddress
Uri

ベース アドレス。

parameters
NameValueCollection

パラメーターの名前と値のペアのコレクション。

omitDefaults
Boolean

true 既定値が無視される場合。それ以外の場合は false。

返品

Uri

URI。

適用対象