SiteMapNode.GetExplicitResourceString(String, String, Boolean) Methode

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

Eine Zeichenfolge, die das lokalisierte Attribut darstellt.

Ausnahmen

ArgumentNullException

attributeName ist null.

InvalidOperationException

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: