Partager via


SiteMapNode.GetExplicitResourceString(String, String, Boolean) Méthode

Définition

Récupère une chaîne localisée selon un attribut SiteMapNode à localiser, une chaîne par défaut à retourner si aucune ressource n'est trouvée, et une valeur Boolean qui indique s'il faut lever une exception si aucune ressource n'est trouvée.

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

Paramètres

attributeName
String

Attribut SiteMapNode à localiser.

defaultValue
String

Valeur par défaut à retourner si aucune ressource correspondante n'est trouvée.

throwIfNotFound
Boolean

true pour lever un InvalidOperationException, si une ressource explicite est définie pour attributeName, si defaultValue affiche une valeur null, et si aucune valeur localisée n'est trouvée ; sinon, false.

Retours

Chaîne qui représente l'attribut localisé.

Exceptions

attributeName a la valeur null.

Aucun objet de ressource correspondant n'a été trouvé et throwIfNotFound affiche une valeur true.

Remarques

La GetExplicitResourceString méthode est appelée dans l’accesseur get de la Title propriété, de la Description propriété et de tous les attributs personnalisés définis dans la Attributes propriété . La SiteMapProvider propriété de l’objet par lequel le SiteMapNode est suivi doit avoir la EnableLocalization valeur pour true que la GetExplicitResourceString méthode retourne une chaîne localisée. Si est EnableLocalization défini sur false, la localisation n’est pas effectuée et la GetExplicitResourceString méthode n’est jamais appelée.

La Title propriété, la Description propriété et tous les attributs personnalisés définis dans la Attributes propriété appellent d’abord la GetImplicitResourceString méthode. Si elle retourne null, la GetExplicitResourceString méthode est appelée avec defaultValue défini sur la valeur de la valeur par défaut de l’expression de ressource explicite (en supposant qu’une a été définie) et throwIfNotFound définie sur true.

Notes

La XmlSiteMapProvider classe impose la restriction selon laquelle l’objet ne peut pas définir à la SiteMapNode fois des expressions de ressource implicites et des expressions de ressource explicites pour les attributs. Toutefois, une implémentation de fournisseur personnalisée peut choisir d’autoriser les deux.

La GetExplicitResourceString méthode utilise la NameValueCollection collection de clés de ressource avec laquelle l’objet SiteMapNode a été initialisé. Si une collection de clés de ressources n’a pas été spécifiée, le GetExplicitResourceString retourne null.

S’applique à

Voir aussi