Freigeben über


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.

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.

defaultValue
String

Der Standardwert, der zurückgegeben werden soll, wenn keine übereinstimmende Ressource gefunden wird.

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.

Gibt zurück

Eine Zeichenfolge, die das lokalisierte Attribut darstellt.

Ausnahmen

attributeName ist null.

Es wurde kein übereinstimmendes Ressourcenobjekt gefunden, und throwIfNotFound ist true.

Hinweise

Die GetExplicitResourceString -Methode wird im get Accessor der Title -Eigenschaft, der Description -Eigenschaft und allen benutzerdefinierten Attributen aufgerufen, die in der Attributes -Eigenschaft definiert sind. Für SiteMapProvider das Objekt, durch das nachverfolgt SiteMapNode wird, muss seine EnableLocalization Eigenschaft auf festgelegt sein, true damit die GetExplicitResourceString Methode eine lokalisierte Zeichenfolge zurückgibt. Wenn auf festgelegt falseist, wird die EnableLocalization Lokalisierung nicht ausgeführt, und die GetExplicitResourceString Methode wird nie aufgerufen.

Die Title -Eigenschaft, die Description -Eigenschaft und alle benutzerdefinierten Attribute, die in der Attributes -Eigenschaft definiert sind, rufen zuerst die GetImplicitResourceString -Methode auf. Wenn sie zurückgibt null, wird die GetExplicitResourceString -Methode aufgerufen und defaultValue auf den Wert des Standardwerts aus dem expliziten Ressourcenausdruck festgelegt (vorausgesetzt, einer wurde definiert) und throwIfNotFound auf truefestgelegt.

Hinweis

Die XmlSiteMapProvider -Klasse legt die Einschränkung fest, dass das SiteMapNode Objekt nicht sowohl implizite Ressourcenausdrücke als auch explizite Ressourcenausdrücke für Attribute definieren kann. Eine benutzerdefinierte Anbieterimplementierung kann jedoch beides zulassen.

Die GetExplicitResourceString -Methode verwendet die NameValueCollection Auflistung von Ressourcenschlüsseln, mit denen das SiteMapNode Objekt initialisiert wurde. Wenn keine Auflistung von Ressourcenschlüsseln angegeben wurde, gibt der GetExplicitResourceString zurück null.

Gilt für:

Weitere Informationen