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 -> 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значение , GetExplicitResourceString метод вызывается с defaultValue присвоением значения по умолчанию из явного выражения ресурса (при условии, что оно определено) и throwIfNotFound присваивается значение true.
Примечание
Класс XmlSiteMapProvider накладывает ограничение на то, что SiteMapNode объект не может определять как неявные выражения ресурсов, так и явные выражения ресурсов для атрибутов. Однако реализация настраиваемого поставщика может разрешить и то, и другое.
Метод GetExplicitResourceString использует коллекцию NameValueCollection ключей ресурсов, с помощью которыми был инициализирован SiteMapNode объект . Если коллекция ключей ресурсов не была указана GetExplicitResourceString , функция возвращает null.
