UriTemplateTable.MakeReadOnly(Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将 UriTemplateTable 设置为只读。
public:
void MakeReadOnly(bool allowDuplicateEquivalentUriTemplates);
public void MakeReadOnly (bool allowDuplicateEquivalentUriTemplates);
member this.MakeReadOnly : bool -> unit
Public Sub MakeReadOnly (allowDuplicateEquivalentUriTemplates As Boolean)
参数
- allowDuplicateEquivalentUriTemplates
- Boolean
指定是否允许 UriTemplate 中有重复的等效 UriTemplateTable 实例。
注解
调用 MakeReadOnly(Boolean) 方法时,会发生下列其中一种验证类型:
如果在调用 MakeReadOnly(Boolean) 时传入
false
,则 UriTemplateTable 会检查以确保表中没有多个结构等效的模板。 如果找到这样的模板,则会引发异常。 如果想要确保只有一个模板与传入的 URI 匹配,则可将此验证类型与 MatchSingle(Uri) 结合使用。如果在调用 MakeReadOnly(Boolean) 时传入
true
,则 UriTemplateTable 中可能包含多个结构等效的模板。 但是,模板中的所有查询字符串必须无歧义;您可以使用相同的查询字符串。 如果允许有多个模板与候选 URI 匹配,则可将此验证类型与 Match(Uri) 结合使用。
系统只接受对 MakeReadOnly(Boolean) 的首次调用,而会忽略后续调用,且不引发任何异常。