Partager via


XmlSiteMapProvider.FindSiteMapNode(String) Méthode

Définition

Récupère un objet SiteMapNode qui représente la page à l'URL spécifiée.

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

Paramètres

rawUrl
String

URL qui identifie la page à laquelle récupérer un SiteMapNode.

Retours

SiteMapNode

SiteMapNode qui représente la page identifiée par rawURL.

Exceptions

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

Remarques

L' XmlSiteMapProvider objet substitue la FindSiteMapNode 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 l’URL spécifiée.

Le rawUrl paramètre doit être un chemin d’accès virtuel absolu ou un chemin d’accès relatif à l’application, en fonction de la façon dont il est spécifié dans le fichier de données de plan de site XML.

La XmlSiteMapProvider classe et les classes qui en sont dérivées utilisent l’URL d’un SiteMapNode objet en tant que clé dans les différentes collections gérées par la classe. Par conséquent, ces URL doivent être uniques dans l’étendue du plan de site. Si l’URL est introuvable dans les données de plan de site immédiates gérées par le XmlSiteMapProvider , elle appelle FindSiteMapNode sur chaque fournisseur enfant qui lui est lié par le biais provider de l’attribut de ses nœuds de plan de site.

La FindSiteMapNode méthode appelle indirectement la BuildSiteMap méthode pour récupérer le nœud de niveau supérieur dans le plan de site. Par conséquent, toutes les exceptions qui se produisent pour la BuildSiteMap méthode peuvent également se produire lors de l’appel de la FindSiteMapNode méthode.

S’applique à

Voir aussi