UriTemplateTable.MakeReadOnly(Boolean) Method

Definition

Makes the UriTemplateTable read only.

public:
 void MakeReadOnly(bool allowDuplicateEquivalentUriTemplates);
public void MakeReadOnly (bool allowDuplicateEquivalentUriTemplates);
member this.MakeReadOnly : bool -> unit
Public Sub MakeReadOnly (allowDuplicateEquivalentUriTemplates As Boolean)

Parameters

allowDuplicateEquivalentUriTemplates
Boolean

Specifies whether to allow duplicate equivalent UriTemplate instances in the UriTemplateTable.

Remarks

When the MakeReadOnly(Boolean) method is called, one of the following types of validation occurs:

  • When MakeReadOnly(Boolean) is called passing in false, the UriTemplateTable checks to make sure the table contains no multiple structurally-equivalent templates. If it finds such templates, an exception is thrown. This type of validation is used in conjunction with MatchSingle(Uri) when you want to ensure only one template matches an incoming URI.

  • When MakeReadOnly(Boolean) is called passing in true, multiple structurally-equivalent templates can be contained within a UriTemplateTable. However, any query strings in the templates must not be ambiguous; identical query strings are allowed. This type of validation is used in conjunction with Match(Uri) when multiple template matches are allowed on the candidate URI.

Only the first call to MakeReadOnly(Boolean) is honored, subsequent calls are ignored without any exception being thrown.

Applies to