다음을 통해 공유


UriTemplate.BindByName 메서드

정의

템플릿에서 새 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> 매개 변수에는 매개 변수 이름 및 값 쌍의 컬렉션이 포함되어 있습니다. 이 매개 변수는 대소문자가 구분되는 비교를 통해 템플릿 내의 변수와 일치시킵니다.

참고

이 메서드에 전달되는 이름/값 컬렉션에는 모든 템플릿 변수에 대한 키가 포함되어야 합니다. 템플릿 변수와 일치하지 않는 추가 이름/값 쌍은 최종 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 -> 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 매개 변수는 매개 변수 이름/값 쌍 컬렉션을 포함합니다. 이 매개 변수는 대소문자가 구분되는 비교를 통해 템플릿 내의 변수와 일치시킵니다. 이 컬렉션에 전달된 값은 이스케이프됩니다.

참고

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 -> 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입니다.

적용 대상