SiteMapProvider.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:
virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNodePublic Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParamètres
- key
- String
Clé de recherche avec laquelle un SiteMapNode est créé.
Retours
SiteMapNode qui représente la page identifiée par key ; sinon, null, si aucun SiteMapNode correspondant n'est présent, ou si l'ajustement de la sécurité est activé et si le SiteMapNode ne peut pas être retourné pour l'utilisateur actuel. La valeur par défaut est null.
Remarques
L’implémentation SiteMapProvider retourne null dans tous les cas. Les classes qui dérivent de la SiteMapProvider classe peuvent remplacer la FindSiteMapNodeFromKey méthode pour fournir des fonctionnalités de recherche en fonction d’une clé unique (au lieu d’une URL, utilisée par la FindSiteMapNode méthode). Implémentez la FindSiteMapNodeFromKey méthode si l’implémentation de votre fournisseur de cartes de site utilise la SiteMapNode.Key propriété d’un SiteMapNode objet comme identificateur principal dans une structure de carte de site.
La StaticSiteMapProvider classe fournit une implémentation qui gère la recherche de nœuds de carte de site qui ne définissent pas d’URL.
La XmlSiteMapProvider classe, qui est le fournisseur de carte de site par défaut pour ASP.NET, utilise l’URL d’une SiteMapNode clé dans les différentes collections conservées par les classes. Par conséquent, si un nœud fournit une URL, il doit être unique dans l’étendue du fournisseur de carte de site. Si aucune URL n’est fournie, un identificateur unique est généré pour identifier le SiteMapNode.