StaticSiteMapProvider.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 avec laquelle un SiteMapNode est créé.
Retours
SiteMapNode qui représente la page identifiée par key ; sinon, null, si l'ajustement de la sécurité est activé et si le nœud de plan de site ne peut pas être présenté à l'utilisateur actuel, ou si la clé key ne parvient pas à le trouver dans la collection de nœuds de plan de site.
Remarques
La FindSiteMapNodeFromKey méthode récupère un nœud de carte de site à partir d’un objet interne Hashtable basé sur key.
L’objetXmlSiteMapProvider, dérivé de la StaticSiteMapProvider classe et qui est le fournisseur de carte de site par défaut pour ASP.NET, utilise la Url propriété d’un SiteMapNode objet comme clé de recherche dans ses collections internes, par défaut. Si la Url propriété du SiteMapNode jeu est définie, elle doit être unique dans l’étendue du fournisseur de carte de site. La FindSiteMapNode méthode tente de récupérer des nœuds de mappage de site en fonction de leur Url. Sinon, vous pouvez utiliser la Key propriété et la méthode correspondante FindSiteMapNodeFromKey pour récupérer les nœuds de carte de site.
L’implémentation StaticSiteMapProvider par défaut recherche des instances de la SiteMapNode classe en fonction du key paramètre. Si un implémenteur de fournisseur de carte de site a utilisé la AddNode méthode, il StaticSiteMapProvider a déjà stocké une référence à chacun SiteMapNode en fonction de la valeur de la SiteMapNode.Key propriété. Par défaut, les XmlSiteMapProvider GUID générés pour les instances de la SiteMapNode classe qui n’ont pas de valeur pour la SiteMapNode.Url propriété. Les implémenteurs de fournisseur de cartes de site personnalisés doivent fournir leur propre mécanisme pour générer des valeurs uniques de la SiteMapNode.Key propriété dans l’événement où une instance de la SiteMapNode classe n’a pas de valeur pour la SiteMapNode.Url propriété.
Les SiteMapProvider classes et XmlSiteMapProvider les classes, qui sont l’implémentation du fournisseur de carte de site par défaut pour ASP.NET, utilisent l’URL d’un SiteMapNode objet comme clé dans les différentes collections que les classes gèrent.