SPXmlContentMapProvider.FindSiteMapNode - Méthode (String)

Article
05/12/2015

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

Espace de noms : Microsoft.SharePoint.Navigation
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Overrides Function FindSiteMapNode ( _
    rawUrl As String _
) As SiteMapNode
'Utilisation
Dim instance As SPXmlContentMapProvider
Dim rawUrl As String
Dim returnValue As SiteMapNode

returnValue = instance.FindSiteMapNode(rawUrl)

public override SiteMapNode FindSiteMapNode(
    string rawUrl
)

Paramètres

rawUrl
Type : System.String

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

Valeur renvoyée

Type : System.Web.SiteMapNode
SiteMapNode qui représente la page identifiée par rawURL. Si aucun SiteMapNode correspondant n'est trouvé, ou si l'ajustement de la sécurité est activé et que le nœud ne peut pas être retourné pour l'utilisateur actuel, la méthode retourne une référence à une référence Null (Rien dans Visual Basic) . (Nothing dans Visual Basic).

Exceptions

Exception	Condition
ArgumentNullException	Une valeur requise String est une référence Null (Rien dans Visual Basic).
InvalidOperationException	Erreur lors de la récupération de l'objet SiteMapNode .

Remarques

L'URL fournie peut être une URL absolue ou virtuelle. Il peut également être une URL qui utilise une syntaxe relative à une application, telle que ~ / apprelativedirectory. Les implémentations qui utilisent cette méthode doivent s'assurer que la syntaxe relative à l'application est analysée correctement.

La classe XmlSiteMapProvider , qui est le fournisseur de plan de site par défaut pour ASP.NET, utilise une URL SiteMapNode en tant que clé dans les différentes collections que les classes gèrent. Cette URL doit être unique dans la portée du fournisseur de plan de site s'il est fourni. Si aucune URL n'est fournie, un identificateur unique est généré pour identifier le SiteMapNode.

Remarques destinées aux héritiers

Lors de la substitution de la méthode SiteMapNode dans une classe dérivée, l'implémenteur doit également rechercher tous les fournisseurs enfants, si un objet SiteMapNode qui correspond à l'URL est introuvable par le fournisseur de plan de site actuel et si le fournisseur prend en charge des fournisseurs enfants.