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 basierend auf einem SiteMapNode Attribut zum Lokalisieren ab, eine Standardzeichenfolge, die zurückgegeben werden soll, wenn keine Ressource gefunden wird, und ein boolescher Wert, 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 SiteMapNode zu lokalisierende Attribut.
- defaultValue
- String
Der standardwert, der zurückgegeben werden soll, wenn eine übereinstimmende Ressource nicht gefunden wird.
- throwIfNotFound
- Boolean
trueum eine InvalidOperationException, wenn eine explizite Ressource für attributeName, defaultValue ist definiert ist null, und ein lokalisierter Wert nicht gefunden wird; andernfalls . false
Gibt zurück
Eine Zeichenfolge, die das lokalisierte Attribut darstellt.
Ausnahmen
attributeName ist null.
Ein übereinstimmende Ressourcenobjekt wurde nicht 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. Das SiteMapProvider Objekt, auf das der SiteMapNode Titel nachverfolgt wird, muss für EnableLocalization die GetExplicitResourceString Methode festgelegt true sein, um eine lokalisierte Zeichenfolge zurückzugeben. Wenn der EnableLocalization Wert auf false"Lokalisierung" festgelegt ist, wird die 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ückgegeben nullwird, wird die GetExplicitResourceString Methode aufgerufen, wobei defaultValue der Wert des Standardwerts aus dem expliziten Ressourcenausdruck (vorausgesetzt, eine definiert wurde) und throwIfNotFound auf .true
Hinweis
Die XmlSiteMapProvider Klasse legt die Einschränkung fest, die das SiteMapNode Objekt nicht sowohl implizite Ressourcenausdrücke als auch explizite Ressourcenausdrücke für Attribute definieren kann. Eine benutzerdefinierte Anbieterimplementierung kann jedoch beide 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, wird die GetExplicitResourceString Rückgabe nullzurückgegeben.
