Поделиться через


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, параметру 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значение , GetExplicitResourceString метод вызывается с defaultValue присвоением значения по умолчанию из явного выражения ресурса (при условии, что оно определено) и throwIfNotFound присваивается значение true.

Примечание

Класс XmlSiteMapProvider накладывает ограничение на то, что SiteMapNode объект не может определять как неявные выражения ресурсов, так и явные выражения ресурсов для атрибутов. Однако реализация настраиваемого поставщика может разрешить и то, и другое.

Метод GetExplicitResourceString использует коллекцию NameValueCollection ключей ресурсов, с помощью которыми был инициализирован SiteMapNode объект . Если коллекция ключей ресурсов не была указана GetExplicitResourceString , функция возвращает null.

Применяется к

См. также раздел