StaticSiteMapProvider.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 ; 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.