SiteMapNode.GetExplicitResourceString(String, String, Boolean) 方法

定义

检索本地化的字符串,此方法基于以下三个参数:要本地化的 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 定义了显式的资源,defaultValuenull,并且未找到本地化的值;否则为 false

返回

String

表示本地化特性的字符串。

例外

attributeNamenull

未找到匹配的资源对象,并且 throwIfNotFoundtrue

注解

该方法GetExplicitResourceStringget属性、Description属性和属性中定义的任何自定义属性的访问器TitleAttributes调用。 SiteMapProvider跟踪的对象SiteMapNode必须设置其EnableLocalization属性,true以便GetExplicitResourceString方法返回本地化字符串。 EnableLocalization如果设置为false本地化,则不会执行本地化,GetExplicitResourceString并且永远不会调用该方法。

属性 TitleDescription 属性和属性在属性中 Attributes 定义的任何自定义属性首先调用该方法 GetImplicitResourceString 。 如果返回null该方法,则defaultValueGetExplicitResourceString调用该方法时,该方法设置为显式资源表达式中的默认值的值, (假定已定义一个值) 并throwIfNotFound设置为 true

备注

XmlSiteMapProvider 类施加 SiteMapNode 了对象不能为属性定义隐式资源表达式和显式资源表达式的限制。 但是,自定义提供程序实现可以选择同时允许这两者。

该方法 GetExplicitResourceString 使用 NameValueCollection 对象初始化的资源键 SiteMapNode 的集合。 如果未指定资源键集合,则 GetExplicitResourceString 返回 null

适用于

另请参阅