XmlSiteMapProvider.FindSiteMapNodeFromKey(String) 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 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.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParamètres
- key
- String
Clé de recherche à utiliser pour rechercher un SiteMapNode.
Retours
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.