This documentation is archived and is not being maintained.

UriTemplate::BindByName Method (Uri, IDictionary<String, String>)

Creates a new URI from the template and the collection of parameters.

Namespace:  System
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public:
Uri^ BindByName(
	Uri^ baseAddress, 
	IDictionary<String^, String^>^ parameters
)

Parameters

baseAddress
Type: System::Uri
The base address.
parameters
Type: System.Collections.Generic::IDictionary<String, String>
A dictionary that contains a collection of parameter name/value pairs.

Return Value

Type: System::Uri
A URI.

The IDictionary<String, String> parameter contains a collection of parameter name and value pairs. The parameters are matched up against the variables within the template by a case-insensitive comparison.

NoteNote

The name/value collection passed to this method must contain a key for every template variable. Extra name/value pairs that do not match template variables are appended to the query string of the final URI.

Security noteSecurity Note

It is possible to pass in text within the name/value pairs that prevent the generated URI from matching the template that is used to generate it. Examples of such text includes: '/', '..', '*', '{', and '}'.

.NET Framework

Supported in: 4, 3.5 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: