SiteMapNode.GetExplicitResourceString(String, String, Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
检索本地化的字符串,此方法基于以下三个参数:要本地化的 SiteMapNode 特性,未找到资源时使用的默认字符串,以及指示在未找到资源时是否引发异常的布尔值。
protected:
System::String ^ GetExplicitResourceString(System::String ^ attributeName, System::String ^ defaultValue, bool throwIfNotFound);
protected string GetExplicitResourceString (string attributeName, string defaultValue, bool throwIfNotFound);
member this.GetExplicitResourceString : string * string * bool -> string
Protected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As String
参数
- attributeName
- String
要本地化的 SiteMapNode 特性。
- defaultValue
- String
未找到匹配资源时返回的默认值。
- throwIfNotFound
- Boolean
设置为 true
则在以下情况下引发 InvalidOperationException:为 attributeName
定义了显式的资源,defaultValue
为 null
,并且未找到本地化的值;否则为 false
。
返回
表示本地化特性的字符串。
例外
attributeName
为 null
。
未找到匹配的资源对象,并且 throwIfNotFound
为 true
。
注解
该方法GetExplicitResourceString在get
属性、Description属性和属性中定义的任何自定义属性的访问器Title中Attributes调用。 SiteMapProvider跟踪的对象SiteMapNode必须设置其EnableLocalization属性,true
以便GetExplicitResourceString方法返回本地化字符串。 EnableLocalization如果设置为false
本地化,则不会执行本地化,GetExplicitResourceString并且永远不会调用该方法。
属性 Title 、 Description 属性和属性在属性中 Attributes 定义的任何自定义属性首先调用该方法 GetImplicitResourceString 。 如果返回null
该方法,则defaultValue
GetExplicitResourceString调用该方法时,该方法设置为显式资源表达式中的默认值的值, (假定已定义一个值) 并throwIfNotFound
设置为 true
。
备注
该 XmlSiteMapProvider 类施加 SiteMapNode 了对象不能为属性定义隐式资源表达式和显式资源表达式的限制。 但是,自定义提供程序实现可以选择同时允许这两者。
该方法 GetExplicitResourceString 使用 NameValueCollection 对象初始化的资源键 SiteMapNode 的集合。 如果未指定资源键集合,则 GetExplicitResourceString 返回 null
。