Partager via


StaticSiteMapProvider.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 ; sinon, null, si aucun nœud de plan de site correspondant n'est trouvé.

Exceptions

rawURL a la valeur null.

Remarques

L’URL fournie est généralement une URL virtuelle ou absolue. Il peut également s’agir d’une URL qui utilise ASP.NET syntaxe relative à l’application, telle que "~/apprelativedirectory". La StaticSiteMapProvider classe normalise automatiquement les URL brutes relatives à l’application en chemin d’accès virtuel absolu.

L’objetXmlSiteMapProvider, dérivé du StaticSiteMapProvider 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. Si aucun ou Key n’est Url spécifié, le fournisseur de carte de site génère automatiquement une Key propriété pour suivre les nœuds de carte de site.

Notes pour les héritiers

Lors de la substitution de la FindSiteMapNode(String) méthode dans une classe dérivée, veillez à normaliser les URL des SiteMapNode objets que vous ajoutez à votre fournisseur de cartes de site afin que la FindSiteMapNode(String) méthode puisse récupérer un nœud de carte de site, que l’URL du nœud de carte de site soit fournie comme chemin virtuel absolu ou un chemin relatif d’application.

Le comportement de découpage de sécurité est inclus dans les implémentations de classe et StaticSiteMapProvider de SiteMapProvider classe. Toutefois, pour que le découpage de sécurité fonctionne dans les classes dérivées, vous devez définir la Roles propriété de tous les SiteMapNode objets que vous créez lors de la création d’un fournisseur de carte de site lorsque vous remplacez la BuildSiteMap() méthode.

S’applique à

Voir aussi