SiteMapNode.GetExplicitResourceString(String, String, Boolean) Methode

Definition

Ruft eine lokalisierte Zeichenfolge auf der Grundlage eines zu lokalisierenden SiteMapNode-Attributs, eine zurückzugebende Standardzeichenfolge (wenn keine Ressource gefunden wird) und einen booleschen Wert ab, der angibt, ob eine Ausnahme ausgelöst werden soll, wenn keine Ressource gefunden wird.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

Parameter

attributeName
String

Das zu lokalisierende SiteMapNode-Attribut.The SiteMapNode attribute to localize.

defaultValue
String

Der Standardwert, der zurückgegeben werden soll, wenn keine übereinstimmende Ressource gefunden wird.The default value to return if a matching resource is not found.

throwIfNotFound
Boolean

true, um eine InvalidOperationException auszulösen, wenn eine explizite Ressource für attributeName definiert ist, defaultValuenull ist und kein lokalisierter Wert gefunden wird, andernfalls 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.

Gibt zurück

Eine Zeichenfolge, die das lokalisierte Attribut darstellt.A string representing the localized attribute.

Ausnahmen

attributeName ist null.attributeName is null.

Es wurde kein übereinstimmendes Ressourcenobjekt gefunden, und throwIfNotFound ist true.A matching resource object was not found and throwIfNotFound is true.

Hinweise

Die GetExplicitResourceString -Methode wird get im-Accessor der Title -Eigenschaft, der Description -Eigenschaft und allen benutzerdefinierten Attributen aufgerufen, die in Attributes der-Eigenschaft definiert sind.The 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. Das SiteMapProvider Objekt, durch das SiteMapNode der nachverfolgt EnableLocalization wird, muss die- true Eigenschaft auf GetExplicitResourceString festlegen, damit die-Methode eine lokalisierte Zeichenfolge zurückgibt.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. Wenn auf falsefestgelegt GetExplicitResourceString ist, wird die Lokalisierung nicht durchgeführt, und die-Methode wird nie aufgerufen. EnableLocalizationIf the EnableLocalization is set to false, localization is not performed and the GetExplicitResourceString method is never called.

Die Title -Eigenschaft, Description die-Eigenschaft und alle benutzerdefinierten Attribute, die in Attributes der-Eigenschaft definiert GetImplicitResourceString sind, rufen zunächst die-Methode auf.The Title property, the Description property, and any custom attributes that are defined in the Attributes property first invoke the GetImplicitResourceString method. nullWenn zurückgegeben wird, GetExplicitResourceString wird die-Methode defaultValue aufgerufen, wobei auf den Wert des Standardwerts aus dem expliziten Ressourcen Ausdruck festgelegt wird (sofern throwIfNotFound definiert) trueund auf festgelegt ist.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.

Hinweis

Die XmlSiteMapProvider -Klasse erzwingt die Einschränkung SiteMapNode , dass das-Objekt nicht sowohl implizite Ressourcen Ausdrücke als auch explizite Ressourcen Ausdrücke für Attribute definieren kann.The XmlSiteMapProvider class imposes the restriction that the SiteMapNode object cannot define both implicit resource expressions and explicit resource expressions for attributes. Eine benutzerdefinierte Anbieter Implementierung kann jedoch beide Optionen zulassen.However, a custom provider implementation can choose to allow both.

Die GetExplicitResourceString -Methode verwendet NameValueCollection die Auflistung von Ressourcen Schlüsseln, SiteMapNode mit denen das Objekt initialisiert wurde.The GetExplicitResourceString method uses the NameValueCollection collection of resource keys that the SiteMapNode object was initialized with. Wenn keine Auflistung von Ressourcen Schlüsseln angegeben wurde, wird GetExplicitResourceString zurück nullgegeben.If a collection of resource keys was not specified, the GetExplicitResourceString returns null.

Gilt für:

Siehe auch