UriTemplate.BindByPosition(Uri, String[]) メソッド

定義

名前空間:

System

アセンブリ:

System.ServiceModel.Web.dll

アセンブリ:

System.ServiceModel.dll

アセンブリ:

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

テンプレートおよびパラメーター値の配列から新しい URI を作成します。

public:
 Uri ^ BindByPosition(Uri ^ baseAddress, ... cli::array <System::String ^> ^ values);

public Uri BindByPosition (Uri baseAddress, params string[] values);

member this.BindByPosition : Uri * string[] -> Uri

Public Function BindByPosition (baseAddress As Uri, ParamArray values As String()) As Uri

パラメーター

baseAddress

Uri

ベース アドレスを格納する Uri。

values

String[]

パラメーター値。

戻り値

Uri

新しい Uri インスタンス。

例

次の例は、BindByPosition(Uri, String[]) を呼び出す方法を示しています。

UriTemplate template = new UriTemplate("weather/{state}/{city}?forecast={day}");
Uri prefix = new Uri("http://localhost");

Uri positionalUri = template.BindByPosition(prefix, "Washington", "Redmond", "Today");

Dim template As UriTemplate = New UriTemplate("weather/{state}/{city}?forecast={day}")
Dim prefix As Uri = New Uri("http://localhost")

Dim positionalUri As Uri = template.BindByPosition(prefix, "Washington", "Redmond", "Today")

注釈

パラメーター値は、左から右の位置でバインドされます。 最初のパラメーター値はテンプレートで見つかった最初の変数を置換し、2 番目のパラメーター値は 2 番目の値を置換し、以降も同様にします。 このメソッドに渡された変数はエスケープされます。

注意

値パラメーターに渡されるパラメーターの数は、テンプレート内の変数の数と一致する必要があります。 一致しない場合は、FormatException がスローされます。

注意

生成された URI が、それを生成するために使用されたテンプレートと照合されないようにするパラメーター値配列に、テキストで渡すことができます。 そのようなテキストの例には、'/'、'.'、'..'、'*'、'{'、および '}' が含まれます。 次のコードでこれを示します。

UriTemplate template = new UriTemplate("far/{bat}/baz");

Uri uri = new Uri("http://localhost/Base");

Uri result = template.BindByPosition(uri, "."); // returns Base/form/baz

Uri result = template.BindByPosition(uri, ".."); // returns Base/baz

Uri result = template.BindByPosition(uri, "x/y"); // returns Base/form/x/y/baz

Uri result = template.BindByPosition(uri, "{x}"); // returns Base/form/{x}/baz

Uri result = template.BindByPosition(uri, "*"); // returns Base/form/*/baz