Partager via


SiteMapProvider.FindSiteMapNodeFromKey(String) Méthode

Définition

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.SiteMapNode
Public Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Paramètres

key
String

Clé de recherche avec laquelle un SiteMapNode est créé.

Retours

SiteMapNode

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.

S’applique à

Voir aussi