다음을 통해 공유


UriTemplate.BindByPosition(Uri, String[]) 메서드

정의

템플릿에서 새 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")

설명

매개 변수 값은 왼쪽에서 오른쪽으로 위치별로 바인딩됩니다. 첫 번째 매개 변수 값이 템플릿에서 발견되는 첫 번째 변수를, 두 번째 매개 변수 값은 두 번째 변수를 대체하는 식으로 진행됩니다. 이 메서드에 전달된 변수는 이스케이프됩니다.

참고

값 매개 변수에 전달된 매개 변수의 개수가 템플릿의 변수 개수와 일치해야 합니다. 그렇지 않으면 FormatException이 throw됩니다.

참고

생성된 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

적용 대상