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 -> stringProtected 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该方法，则defaultValueGetExplicitResourceString调用该方法时，该方法设置为显式资源表达式中的默认值的值， (假定已定义一个值) 并throwIfNotFound设置为 true。
备注
该 XmlSiteMapProvider 类施加 SiteMapNode 了对象不能为属性定义隐式资源表达式和显式资源表达式的限制。 但是，自定义提供程序实现可以选择同时允许这两者。
该方法 GetExplicitResourceString 使用 NameValueCollection 对象初始化的资源键 SiteMapNode 的集合。 如果未指定资源键集合，则 GetExplicitResourceString 返回 null。