SiteMapNode.GetExplicitResourceString(String, String, Boolean) Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Возвращает локализованную строку, основываясь на атрибуте 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.

Возвращаемое значение

String

Строка, представляющая локализованный атрибут.

Исключения

ArgumentNullException

attributeName имеет значение null.

InvalidOperationException

Соответствующий объект ресурса не найден, и параметру 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.

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

• EnableLocalization
• GetImplicitResourceString(String)