UriTemplateTable.MakeReadOnly Method (Boolean)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Makes the UriTemplateTable read only.

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

Public Sub MakeReadOnly (
	allowDuplicateEquivalentUriTemplates As Boolean
)

Parameters

allowDuplicateEquivalentUriTemplates
Type: System.Boolean

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

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.

.NET Framework
Available since 3.5
Return to top
Show: