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