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

Определение

Возвращает локализованную строку, основываясь на атрибуте SiteMapNode для локализации или используемую по умолчанию строку, если ресурс не найден, и логическую величину, показывающую, выдается ли исключение, если ресурс не найден.Retrieves a localized string based on a SiteMapNode attribute to localize, a default string to return if no resource is found, and a Boolean value indicating whether to throw an exception if no resource is found.

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 для локализации.The SiteMapNode attribute to localize.

defaultValue
String

Значение по умолчанию для возврата, если ресурс не найден.The default value to return if a matching resource is not found.

throwIfNotFound
Boolean

Значение true, чтобы выдавать исключение InvalidOperationException, если явный ресурс описан для параметра attributeName, параметру defaultValue присвоено значение null и локализованное значение не найдено; в противном случае — значение false.true to throw an InvalidOperationException, if an explicit resource is defined for attributeName, defaultValue is null, and a localized value is not found; otherwise, false.

Возвраты

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

Исключения

Свойство attributeName имеет значение null.attributeName is null.

Соответствующий объект ресурса не найден, и параметру throwIfNotFound присвоено значение true.A matching resource object was not found and throwIfNotFound is true.

Комментарии

get Title Description Метод вызывается в методе доступа свойства, Attributes свойства и любых пользовательских атрибутов, определенных в свойстве. GetExplicitResourceStringThe GetExplicitResourceString method is invoked in the get accessor of the Title property, the Description property, and any custom attributes that are defined in the Attributes property. SiteMapNode EnableLocalization true Для SiteMapProvider объекта,покоторомупроизводитсятрассировка,свойстводолжноиметьзначение,чтобыметодвозвращалGetExplicitResourceString локализованную строку.The SiteMapProvider object by which the SiteMapNode is tracked must have its EnableLocalization property set to true for the GetExplicitResourceString method to return a localized string. Если параметр false GetExplicitResourceString имеет значение, локализация не выполняется и метод никогда не вызывается. EnableLocalizationIf the EnableLocalization is set to false, localization is not performed and the GetExplicitResourceString method is never called.

Свойство, свойство и все пользовательские атрибуты Attributes , определенные в свойстве, сначала вызывают GetImplicitResourceString метод. Description TitleThe Title property, the Description property, and any custom attributes that are defined in the Attributes property first invoke the GetImplicitResourceString method. Если он возвращает null GetExplicitResourceString , метод вызывается с defaultValue параметром, равным значению по умолчанию из явного выражения ресурса ( trueпри условии, что оно определено) и throwIfNotFound имеет значение.If it returns null, the GetExplicitResourceString method is invoked with defaultValue set to the value of the default value from the explicit resource expression (assuming one was defined) and throwIfNotFound set to true.

Примечание

Класс накладывает ограничение, что SiteMapNode объект не может определить как неявные выражения ресурсов, так и явные выражения ресурсов для атрибутов. XmlSiteMapProviderThe XmlSiteMapProvider class imposes the restriction that the SiteMapNode object cannot define both implicit resource expressions and explicit resource expressions for attributes. Однако реализация пользовательского поставщика может разрешить оба варианта.However, a custom provider implementation can choose to allow both.

Метод использует коллекцию ключей ресурсов, с которыми SiteMapNode был инициализирован объект. NameValueCollection GetExplicitResourceStringThe GetExplicitResourceString method uses the NameValueCollection collection of resource keys that the SiteMapNode object was initialized with. Если коллекция ключей ресурсов не указана, возвращается GetExplicitResourceString nullзначение.If a collection of resource keys was not specified, the GetExplicitResourceString returns null.

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

Дополнительно