XmlSiteMapProvider.FindSiteMapNode(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 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.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeParamètres
- rawUrl
- String
URL qui identifie la page à laquelle récupérer un SiteMapNode.
Retours
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.