UriTemplate.BindByName メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テンプレートおよびパラメーターのコレクションから新しい 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> -> UriPublic Function BindByName (baseAddress As Uri, parameters As IDictionary(Of String, String)) As Uriパラメーター
- baseAddress
- Uri
ベース アドレス。
- parameters
- IDictionary<String,String>
パラメーター名と値のペアのコレクションを含むディクショナリ。
戻り値
URI。
注釈
IDictionary<string,string> パラメーターには、パラメーター名と値のペアのコレクションが含まれています。 パラメーターは、大文字と小文字を区別する比較でテンプレート内の変数を比較します。
注意
このメソッドに渡された名前と値のコレクションには、すべてのテンプレート変数のキーを含める必要があります。 テンプレート変数に一致しない追加の名前と値のペアは、最終的な URI のクエリ文字列に付加されます。
重要
生成された 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 -> UriPublic Function BindByName (baseAddress As Uri, parameters As NameValueCollection) As Uriパラメーター
- baseAddress
- Uri
ベース アドレス。
- parameters
- NameValueCollection
パラメーター値。
戻り値
新しいインスタンス。
例
次の例では、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 パラメーター。 パラメーターは、大文字と小文字を区別する比較でテンプレート内の変数を比較します。 このコレクションに渡された値はエスケープされます。
注意
BindByName(Uri, NameValueCollection) に渡された名前と値のコレクションは、すべてのテンプレート変数のキーを格納する必要があります。 テンプレート変数に一致しない追加の名前と値のペアは、最終的な URI のクエリ文字列に付加されます。
注意
生成された 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 -> UriPublic 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。
適用対象
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 -> UriPublic Function BindByName (baseAddress As Uri, parameters As NameValueCollection, omitDefaults As Boolean) As Uriパラメーター
- baseAddress
- Uri
ベース アドレス。
- parameters
- NameValueCollection
パラメーター名と値のペアのコレクション。
- omitDefaults
- Boolean
既定値を無視する場合は、true。それ以外の場合は、false。
戻り値
URI。