Partager via


XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Méthode

Définition

Récupère un objet SiteMapNode selon une clé spécifiée.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Paramètres

key
String

Clé de recherche à utiliser pour rechercher un SiteMapNode.

Retours

SiteMapNode

SiteMapNode qui représente la page identifiée par key ; sinon, null, si l'ajustement de la sécurité est activé et que le nœud ne peut pas être présenté à l'utilisateur actuel ou si key ne parvient pas à trouver le nœud dans la collection de nœuds.

Exceptions

Un fournisseur enfant lié au fournisseur de plan de site en cours a retourné un nœud qui n'est pas valide.

Remarques

La XmlSiteMapProvider classe substitue la FindSiteMapNodeFromKey méthode pour garantir que tous les fournisseurs enfants liés sont recherchés pour le nœud, si l’implémentation de la classe de base ne retourne pas de nœud pour key .

l' XmlSiteMapProvider objet, dérivé de la StaticSiteMapProvider classe et du fournisseur de plan de site par défaut pour ASP.NET, utilise la Url propriété d’un SiteMapNode objet en tant que clé de recherche dans ses collections internes, par défaut. Si la Url propriété du SiteMapNode est définie, elle doit être unique dans l’étendue du fournisseur. Si aucun Url n’est spécifié, le XmlSiteMapProvider génère automatiquement un Key pour effectuer le suivi des nœuds.

La FindSiteMapNodeFromKey méthode peut appeler la BuildSiteMap méthode sur tous les fournisseurs enfants associés au fournisseur actuel. Par conséquent, les exceptions qui sont décrites dans la BuildSiteMap méthode peuvent être levées.

S’applique à

Voir aussi