Vue d'ensemble du contrôle serveur Web SiteMapPath

Article
10/22/2014

Mise à jour : novembre 2007

SiteMapPath affiche un chemin de navigation, également appelé fil d'Ariane (breadcrumb) ou « sourcil » (eyebrow), qui indique l'emplacement de la page active à l'utilisateur et affiche des liens sous la forme d'un chemin de retour à la page d'accueil.

Cette rubrique contient les sections suivantes :

Contexte
Exemples de code
Référence de classe

Contexte

Le contrôle SiteMapPath obtient des données de navigation d'un plan de site. Ces données contiennent des informations sur les pages de votre site Web, telles que l'URL, le titre, la description et l'emplacement dans la hiérarchie de navigation. Le stockage des données de navigation à un emplacement unique facilite l'ajout et la suppression des éléments dans les menus de navigation d'un site Web.

L'exemple de code suivant présente des données sitemap qui sont incluses dans un fichier Web.sitemap.

<siteMap>
  <siteMapNode title="Home" description="Home" url="~/default.aspx" >
    <siteMapNode title="Services" description="Services we offer" 
      url="~/Services.aspx">
    <siteMapNode title="Training" description="Training classes" 
      url="~/Training.aspx" />
    <siteMapNode title="Consulting" description="Consulting services" 
      url="~/Consulting.aspx" />
    </siteMapNode>
  </siteMapNode>
</siteMap>

Remarque :
Seules les pages répertoriées dans le plan de site peuvent afficher des données de navigation dans le contrôle SiteMapPath. Si vous placez un contrôle SiteMapPath sur une page qui n'est pas répertoriée dans le plan de site, il n'affichera rien au client.

Vous pouvez ajouter un contrôle SiteMapPath à la page Training.aspx en ajoutant le code suivant.

<asp:SiteMapPath ID="SiteMapPath1" Runat="server"></asp:SiteMapPath>

Lorsque la page Training.aspx est affichée dans le navigateur, le contrôle SiteMapPath affiche des données similaires à l'exemple suivant, les pages Home et Services étant restituées sous la forme de liens hypertexte :

Home > Services > Training

Vous pouvez utiliser le contrôle SiteMapPath pour créer la navigation de site sans code et sans données de liaison. Le contrôle peut lire et restituer automatiquement les informations sitemap. Toutefois, en cas de besoin, vous pouvez également utiliser le contrôle SiteMapPath pour modifier les données sitemap. Pour plus d'informations, consultez Comment : modifier par programme des nœuds sitemap dans la mémoire.

Le contrôle SiteMapPath permet aux utilisateurs de naviguer vers l'arrière, c'est-à-dire de la page actuelle vers les pages placées plus haut dans la hiérarchie du site. Toutefois, le contrôle SiteMapPath ne permet pas aux utilisateurs de naviguer vers l'avant, c'est-à-dire de la page actuelle vers une autre page placée plus bas dans la hiérarchie du site. Par exemple, vous pouvez utiliser le contrôle SiteMapPath dans les applications de groupe de discussion ou de forum électronique pour permettre aux utilisateurs d'afficher le chemin d'accès à l'article qu'ils parcourent actuellement.

Exemples de code

Comment : ajouter la navigation de site simple

Comment : personnaliser l'apparence des contrôles serveur Web SiteMapPath

Comment : configurer plusieurs plans de sites et fournisseurs sitemap

Retour au début

Référence de classe

Le tableau suivant répertorie les classes liées au contrôle SiteMapPath.

Membre	Description
SiteMapPath	Principale classe du contrôle.

Retour au début

Voir aussi

Partager via

Vue d'ensemble du contrôle serveur Web SiteMapPath

Contexte

Exemples de code

Référence de classe

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires