SiteMapNode.GetExplicitResourceString(String, String, Boolean) Methode
Definition
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 -> stringProtected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As StringParameter
- 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.
