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

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

String

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

Exceptions

ArgumentNullException

attributeName a la valeur null.

InvalidOperationException

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 à