UriTemplateTable.MakeReadOnly(Boolean) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.