SiteMapNode.GetExplicitResourceString(String, String, Boolean) Méthode
Définition
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 en fonction d’un SiteMapNode attribut à localiser, une chaîne par défaut à retourner si aucune ressource n’est trouvée et une valeur booléenne indiquant 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 -> stringProtected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As StringParamètres
- attributeName
- String
Attribut SiteMapNode à localiser.
- defaultValue
- String
Valeur par défaut à retourner si une ressource correspondante est introuvable.
- throwIfNotFound
- Boolean
true pour lever un InvalidOperationException, si une ressource explicite est définie pour attributeName, defaultValue est null, et une valeur localisée est introuvable ; sinon, false.
Retours
Chaîne représentant l’attribut localisé.
Exceptions
attributeName a la valeur null.
Un objet de ressource correspondant n’a pas été trouvé et throwIfNotFound est true.
Remarques
La GetExplicitResourceString méthode est appelée dans l’accesseur get de la propriété, de la TitleDescription propriété et de tous les attributs personnalisés définis dans la Attributes propriété. L’objet SiteMapProvider par lequel le SiteMapNode suivi doit avoir sa EnableLocalization propriété définie true pour que la GetExplicitResourceString méthode retourne une chaîne localisée. Si la valeur est définiefalse, la EnableLocalization 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 la valeur définie sur 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.
Note
La XmlSiteMapProvider classe impose la restriction que l’objet SiteMapNode ne peut pas définir à la fois les expressions de ressource implicites et les 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 aucune collection de clés de ressource n’a été spécifiée, la GetExplicitResourceString valeur renvoie null.
