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 SiteMapNode objet 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 pour laquelle récupérer un SiteMapNode.
Retours
Qui SiteMapNode représente la page identifiée par rawURL.
Exceptions
Un fournisseur enfant lié au fournisseur de carte de site actuel a retourné un nœud qui n’est pas valide.
Remarques
L’objet XmlSiteMapProvider remplace la FindSiteMapNode méthode pour s’assurer 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 virtuel absolu ou un chemin d’accès relatif à l’application, selon la façon dont il est spécifié dans le fichier de données de carte de site XML.
La XmlSiteMapProvider classe et les classes dérivées de celle-ci utilisent l’URL d’un SiteMapNode objet comme clé dans les différentes collections que la classe gère. Par conséquent, ces URL doivent être uniques dans l’étendue de la carte de site. Si l’URL n’est pas trouvée dans les données de carte de site immédiates gérées par le XmlSiteMapProviderservice , elle appelle le FindSiteMapNode fournisseur enfant lié à celui-ci via l’attribut provider de ses nœuds de carte de site.
La FindSiteMapNode méthode appelle indirectement la BuildSiteMap méthode pour récupérer le nœud de niveau supérieur dans la carte 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.