Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SiteMapPath, classe

Affiche un jeu de texte ou des images-liens hypertexte qui occupent un espace de page restreint et permettent aux utilisateurs de naviguer plus facilement sur un site Web.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public class SiteMapPath : CompositeControl
<asp:SiteMapPath />

Le type SiteMapPath expose les membres suivants.

  NomDescription
Méthode publiqueSiteMapPathInitialise une nouvelle instance de la classe SiteMapPath.
Début

  NomDescription
Propriété publiqueAccessKeyObtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeAdapterObtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueAttributesObtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.)
Propriété publiqueBackColorObtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publiqueBorderColorObtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publiqueBorderStyleObtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBorderWidthObtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.)
Propriété protégéeContextObtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publiqueControlsObtient un objet ControlCollection qui représente les contrôles enfants de CompositeControl. (Hérité de CompositeControl.)
Propriété publiqueControlStyleObtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueControlStyleCreatedObtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueCssClassObtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.)
Propriété publiqueCurrentNodeStyleObtient le style utilisé pour le texte affiché appliqué au nœud actuel.
Propriété publiqueCurrentNodeTemplateObtient ou définit un modèle de contrôle à utiliser pour le nœud d'un chemin de navigation de site qui représente la page affichée.
Propriété publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueEnabledObtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publiqueEnableViewStateObtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.)
Propriété protégéeEventsObtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété publiqueFontObtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueForeColorObtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueHasAttributesObtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégéeHasChildViewStateObtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.)
Propriété publiqueHeightObtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueIDObtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégéeIsChildControlStateClearedObtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
Propriété protégéeIsEnabledObtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégéeIsTrackingViewStateObtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégéeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégéeLoadViewStateByIDObtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.)
Propriété publiqueNamingContainerObtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control.ID possède la même valeur. (Hérité de Control.)
Propriété publiqueNodeStyleObtient le style utilisé pour le texte affiché appliqué à tous les nœuds du chemin de navigation du site.
Propriété publiqueNodeTemplateObtient ou définit un modèle de contrôle à utiliser pour l'ensemble des nœuds fonctionnels d'un chemin de navigation de site.
Propriété publiquePageObtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publiqueParentLevelsDisplayedObtient ou définit le nombre de niveaux de nœuds parents affichés par le contrôle par rapport au nœud affiché.
Propriété publiquePathDirectionObtient ou définit l'ordre d'affichage des nœuds du chemin de navigation.
Propriété publiquePathSeparatorObtient ou définit la chaîne qui délimite les nœuds SiteMapPath dans le chemin de navigation affiché.
Propriété publiquePathSeparatorStyleObtient le style appliqué à la chaîne PathSeparator.
Propriété publiquePathSeparatorTemplateObtient ou définit le modèle de contrôle à utiliser pour le séparateur de chemin d'accès d'un chemin de navigation de site.
Propriété publiqueProviderObtient ou définit un SiteMapProvider associé au contrôle serveur Web.
Propriété publiqueRenderCurrentNodeAsLinkIndique si le nœud de navigation du site qui représente la page affichée se présente sous la forme d'un lien hypertexte.
Propriété publiqueRenderingCompatibilityObtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété publiqueRootNodeStyleObtient le style appliqué au texte affiché du nœud racine.
Propriété publiqueRootNodeTemplateObtient ou définit le modèle de contrôle à utiliser pour le nœud racine d'un chemin de navigation de site.
Propriété publiqueShowToolTipsObtient ou définit une valeur qui indique si le contrôle SiteMapPath écrit un attribut de lien hypertexte supplémentaire pour les nœuds de navigation reliés par des liens hypertexte. En fonction de la prise en charge des clients, une info-bulle peut s'afficher lorsque le pointeur de la souris passe sur un lien hypertexte possédant un attribut supplémentaire défini.
Propriété publiqueSiteObtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.)
Propriété publiqueSiteMapProviderObtient ou définit le nom du SiteMapProvider utilisé pour afficher le contrôle de navigation de site.
Propriété publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publiqueSkipLinkTextObtient ou définit une valeur utilisée pour afficher le texte de remplacement afin de permettre aux lecteurs d'écran d'ignorer le contenu du contrôle.
Propriété publiqueStyleObtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueSupportsDisabledAttributeObtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Hérité de CompositeControl.)
Propriété publiqueTabIndexObtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeTagKeyObtient la valeur HtmlTextWriterTag qui correspond au contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété protégéeTagNameObtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publiqueToolTipObtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueUniqueIDObtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publiqueValidateRequestModeObtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control.)
Propriété protégéeViewStateObtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.)
Propriété protégéeViewStateIgnoresCaseObtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleObtient ou définit une valeur qui indique si un contrôle serveur est rendu sous la forme d'une interface utilisateur sur la page. (Hérité de Control.)
Propriété publiqueWidthObtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début

  NomDescription
Méthode protégéeAddAttributesToRenderAjoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeAddedControlAppelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégéeAddParsedSubObjectAvertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publiqueApplyStyleCopie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publiqueApplyStyleSheetSkinApplique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.)
Méthode protégéeBeginRenderTracingCommence le traçage au moment du design des données de rendu. (Hérité de Control.)
Méthode protégéeBuildProfileTreeInfrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode protégéeClearCachedClientIDInfrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildViewStateSupprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.)
Méthode publiqueCopyBaseAttributesCopie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeCreateChildControlsInfrastructure. Efface la collection de contrôles enfants actuelle et la reconstruit en appelant la méthode CreateControlHierarchy. (Substitue Control.CreateChildControls().)
Méthode protégéeCreateControlCollectionCrée un nouvel objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control.)
Méthode protégéeCreateControlHierarchyExamine la structure du plan de site fournie par le SiteMapProvider et construit une collection de contrôles enfants basée sur les styles et les modèles définis pour les nœuds fonctionnels.
Méthode protégéeCreateControlStyleCrée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publiqueDataBind()Infrastructure. Lie une source de données au contrôle SiteMapPath et à ses contrôles enfants. (Substitue CompositeControl.DataBind().)
Méthode protégéeDataBind(Boolean)Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.)
Méthode protégéeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDisposePermet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingMet fin au traçage au moment du design des données de rendu. (Hérité de Control.)
Méthode protégéeEnsureChildControlsDétermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.)
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(String)Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control.)
Méthode protégéeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.)
Méthode publiqueFocusAffecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégéeGetDesignModeStateInfrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégéeInitializeItemRemplit un SiteMapNodeItem, qui est un contrôle serveur Web qui représente un SiteMapNode, avec un jeu de contrôles enfants selon la fonction du nœud ainsi que des modèles et des styles spécifiés pour celui-ci.
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateRestaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState. (Hérité de Control.)
Méthode protégéeLoadViewStateRestaure les informations d'état d'affichage à partir d'une précédente requête enregistrées avec la méthode SaveViewState. (Substitue WebControl.LoadViewState(Object).)
Méthode protégéeMapPathSecureRécupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMergeStyleCopie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeOnBubbleEventDétermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnDataBindingInfrastructure. Substitue la méthode OnDataBinding de la classe CompositeControl et déclenche l'événement DataBinding. (Substitue Control.OnDataBinding(EventArgs).)
Méthode protégéeOnInitDéclenche l'événement Init. (Hérité de Control.)
Méthode protégéeOnItemCreatedDéclenche l'événement ItemCreated du contrôle SiteMapPath.
Méthode protégéeOnItemDataBoundDéclenche l'événement ItemDataBound du contrôle SiteMapPath.
Méthode protégéeOnLoadDéclenche l'événement Load. (Hérité de Control.)
Méthode protégéeOnPreRenderDéclenche l'événement PreRender. (Hérité de Control.)
Méthode protégéeOnUnloadDéclenche l'événement Unload. (Hérité de Control.)
Méthode protégéeOpenFileObtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéeRaiseBubbleEventAssigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRecreateChildControlsRecrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl.)
Méthode protégéeRemovedControlAppelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégéeRenderÉcrit le contenu CompositeControl dans l'objet HtmlTextWriter spécifié pour qu'il s'affiche sur le client. (Substitue CompositeControl.Render(HtmlTextWriter).)
Méthode publiqueRenderBeginTagGénère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeRenderChildrenRenvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
Méthode protégéeRenderContentsGénère le rendu des nœuds dans le contrôle SiteMapPath. (Substitue WebControl.RenderContents(HtmlTextWriter).)
Méthode publiqueRenderControl(HtmlTextWriter)Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de Control.)
Méthode protégéeRenderControl(HtmlTextWriter, ControlAdapter)Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.)
Méthode publiqueRenderEndTagGénère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeResolveAdapterObtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre les modifications éventuellement apportées à l'état du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.)
Méthode protégéeSaveViewStateInfrastructure. Enregistre les modifications relatives à l'état d'affichage du contrôle SiteMapPath. (Substitue WebControl.SaveViewState().)
Méthode protégéeSetDesignModeStateDéfinit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueSetRenderMethodDelegateInfrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeTrackViewStateInfrastructure. Suit les modifications apportées à l'état d'affichage du contrôle SiteMapPath. (Substitue WebControl.TrackViewState().)
Début

  NomDescription
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDisposedSe produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.)
Événement publicInitSe produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.)
Événement publicItemCreatedSe produit lorsqu'un SiteMapNodeItem est créé par le SiteMapPath et associé à son SiteMapNode correspondant. Cet événement est déclenché par la méthode OnItemCreated.
Événement publicItemDataBoundInfrastructure. Se produit après la liaison d'un SiteMapNodeItem à ses données SiteMapNode sous-jacentes par le SiteMapPath. Cet événement est déclenché par la méthode OnItemDataBound.
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement publicPreRenderSe produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début

  NomDescription
Méthode d'extension publiqueFindDataSourceControlRetourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindFieldTemplateRetourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.GetAttributeInfrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.SetAttributeAffecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeICompositeControlDesignerAccessor.RecreateChildControlsPermet à un concepteur de recréer dans l'environnement au moment du design la collection du contrôle composite de contrôles enfants. (Hérité de CompositeControl.)
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Début

Dans cette rubrique :

Introduction

Le contrôle SiteMapPath est un contrôle de navigation de site qui reflète les données fournies par l'objet SiteMap. Il s'agit d'un outil de navigation compact également utilisé comme de point de référence pour déterminer l'emplacement de la page affichée sur un site. Ce type de contrôle est généralement appelé fil d'Ariane (breadcrumb) ou « sourcil » (eyebrow) parce qu'il affiche un chemin d'accès hiérarchique des noms de pages reliés par des liens hypertexte qui permettent de remonter la hiérarchie de pages à partir de l'emplacement actuel. SiteMapDataSource . SiteMapPath est utile pour les sites qui possèdent des structures de pages hiérarchiques profondes, mais où un TreeView ou un Menu peut requérir un espace important sur une page.

Le contrôle SiteMapPath fonctionne directement avec les données de plan de site de votre site Web. Si vous l'utilisez sur une page qui n'est pas représentée dans votre plan de site, il ne sera pas affiché. Pour plus d'informations sur les plans de sites, consultez ASP.NET Site Navigation.

Nœuds

Le SiteMapPath est composé de nœuds. Chaque élément du chemin d'accès est appelé un nœud et est représenté par un objet SiteMapNodeItem. Le nœud qui ancre le chemin d'accès et représente la base de l'arborescence hiérarchique est appelé le nœud racine. Le nœud qui représente la page affichée est le nœud actuel. Tout autre nœud situé entre le nœud actuel et le nœud racine est un nœud parent. Le tableau suivant décrit les trois types de nœuds.

Type de nœud

Description

racine

Nœud d'ancrage d'un jeu hiérarchique de nœuds.

parent

Nœud qui possède un ou plusieurs nœuds enfants, mais qui n'est pas le nœud actuel.

actuel

Nœud qui représente la page affichée.

Apparence des nœuds

Chaque nœud affiché par un SiteMapPath est un contrôle HyperLink ou Literal auquel vous pouvez appliquer un modèle ou un style. Les modèles et les styles sont appliqués aux nœuds suivant deux règles de priorité :

  • Si un modèle est défini pour un nœud, il substitue tout style défini pour celui-ci.

  • Les modèles et les styles spécifiques aux types de nœuds se substituent aux modèles et styles généraux définis pour tous les nœuds.

Les propriétés NodeStyle et NodeTemplate sont appliquées à tous les nœuds, indépendamment de leur type. Si ces deux propriétés sont définies, la propriété NodeTemplate est prioritaire.

Les propriétés CurrentNodeTemplate et CurrentNodeStyle sont appliquées aux nœuds qui représentent la page affichée. Si un NodeTemplate est défini en plus de CurrentNodeTemplate, il est ignoré. Si un NodeStyle est défini en plus de CurrentNodeStyle, il est fusionné avec le CurrentNodeStyle pour créer un style fusionné. Celui-ci utilise tous les éléments du CurrentNodeStyle ainsi que tous les éléments supplémentaires du NodeStyle qui ne sont pas en conflit avec le CurrentNodeStyle.

Les propriétés RootNodeTemplate et RootNodeStyle sont appliquées au nœud qui représente la racine de la hiérarchie de navigation du site. Si un NodeTemplate est défini en plus de RootNodeTemplate, il est ignoré. Si un NodeStyle est défini en plus de RootNodeStyle, il est fusionné avec le RootNodeStyle pour créer un style fusionné. Celui-ci utilise tous les éléments du RootNodeStyle ainsi que tous les éléments supplémentaires du NodeStyle qui ne sont pas entrés en conflit avec le CurrentNodeStyle. Enfin, si la page affichée est la page racine du site, le RootNodeTemplate et le RootNodeStyle sont utilisés à la place du CurrentNodeTemplate ou du CurrentNodeStyle.

Le contrôle SiteMapPath utilise le fournisseur de plan de site identifié par la propriété SiteMapProvider comme sa source de données pour obtenir des informations de navigation de site. Si aucun fournisseur n'est spécifié, il utilise le fournisseur par défaut pour le site, identifié dans la propriété SiteMap.Provider. Il s'agit généralement d'une instance du fournisseur de plan de site par défaut pour ASP.NET, le XmlSiteMapProvider. Si le contrôle SiteMapPath est utilisé dans un site mais qu'aucun fournisseur de plan de site n'est configuré, il lève une exception HttpException.

Événements

Le contrôle SiteMapPath fournit également des événements que vous pouvez programmer. Cela vous permet d'exécuter une routine personnalisée lorsqu'un événement se produit. Le tableau suivant répertorie les événements pris en charge par le contrôle SiteMapPath.

Événement

Description

ItemCreated

Se produit lorsque le contrôle SiteMapPath crée d'abord un SiteMapNodeItem et l'associe à un SiteMapNode.

ItemDataBound

Se produit lorsqu'un SiteMapNodeItem est lié à des données de plan de site incluses dans le SiteMapNode.

Personnalisation du contrôle SiteMapPath

Les classes dérivées de SiteMapPath substituent la méthode InitializeItem pour personnaliser les contrôles SiteMapNodeItem inclus dans le contrôle de navigation. Pour contrôler complètement la création et l'ajout des objets SiteMapNodeItem au SiteMapPath, les classes dérivées substituent la méthode CreateControlHierarchy.

Accessibilité

Pour plus d'informations sur la configuration de ce contrôle afin qu'il génère des balises conforment aux standards d'accessibilité, consultez Accessibility in Visual Studio 2010 and ASP.NET 4 et ASP.NET Controls and Accessibility.

Syntaxe déclarative

<asp:SiteMapPath
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    ParentLevelsDisplayed="integer"
    PathDirection="RootToCurrent|CurrentToRoot"
    PathSeparator="string"
    RenderCurrentNodeAsLink="True|False"
    runat="server"
    ShowToolTips="True|False"
    SiteMapProvider="string"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <CurrentNodeStyle />
        <CurrentNodeTemplate>
            <!-- child controls -->
        </CurrentNodeTemplate>
        <NodeStyle />
        <NodeTemplate>
            <!-- child controls -->
        </NodeTemplate>
        <PathSeparatorStyle />
        <PathSeparatorTemplate>
            <!-- child controls -->
        </PathSeparatorTemplate>
        <RootNodeStyle />
        <RootNodeTemplate>
            <!-- child controls -->
        </RootNodeTemplate>
</asp:SiteMapPath>
TopicLocation
Comment : énumérer par programme des nœuds sitemapGénération d'applications Web ASP.NET
Comment : filtrer les nœuds récupérés par les contrôles serveur Web SiteMapDataSourceGénération d'applications Web ASP.NET
Comment : configurer plusieurs plans de sites et fournisseurs sitemapGénération d'applications Web ASP.NET
Comment : localiser les données sitemapGénération d'applications Web ASP.NET
Comment : implémenter des fournisseurs sitemap ASP.NETGénération d'applications Web ASP.NET
Comment : modifier par programme des nœuds sitemap dans la mémoireGénération d'applications Web ASP.NET
Comment : personnaliser l'apparence des contrôles serveur Web SiteMapPathGénération d'applications Web ASP.NET
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET
Comment : ajouter la navigation de site simpleGénération d'applications Web ASP.NET
Procédure pas à pas : ajout de la navigation de site à un site WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : énumérer par programme des nœuds sitemapGénération d'applications Web ASP.NET dans Visual Studio
Comment : configurer plusieurs plans de sites et fournisseurs sitemapGénération d'applications Web ASP.NET dans Visual Studio
Comment : filtrer les nœuds récupérés par les contrôles serveur Web SiteMapDataSourceGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : ajout de la navigation de site à un site WebGénération d'applications à l'aide de Visual Web Developer
Comment : modifier par programme des nœuds sitemap dans la mémoireGénération d'applications Web ASP.NET dans Visual Studio
Comment : localiser les données sitemapGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser l'apparence des contrôles serveur Web SiteMapPathGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter la navigation de site simpleGénération d'applications Web ASP.NET dans Visual Studio
Comment : implémenter des fournisseurs sitemap ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter la navigation de site simpledv_vwdcon

L'exemple de code suivant utilise un contrôle SiteMapPath de façon déclarative dans une page Web Forms. Cet exemple présente quelques règles de priorité régissant l'ordre d'application des modèles et des styles aux nœuds SiteMapPath.


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 The NodeStyle and RootNodeStyle define the same attributes,
                 but are different and conflict with each other: the
                 RootNodeStyle supersedes NodeStyle, and is the style
                 rendered. Notice, however, that the underline style
                 defined by NodeStyle is still applied.

                 Both a CurrentNodeStyle and a CurrentNodeTemplate are
                 defined. A template supersedes a style for a node
                 type, so CurrentNodeTemplate is displayed and CurrentNodeStyle
                 is ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <CURRENTNODETEMPLATE>
                        <asp:Image id="Image1" runat="server" ImageUrl="WebForm2.jpg" AlternateText="WebForm2"/>
                </CURRENTNODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>


L'exemple précédent utilise le fournisseur de plan de site par défaut et un fichier Web.sitemap avec la structure suivante.

<siteMap>
  <siteMapNode title="WebForm1" description="WebForm1" url="WebForm1.aspx" >
    <siteMapNode title="WebForm2" description="WebForm2" url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

L'exemple de code suivant montre l'extension et l'ajout de nouvelles fonctionnalités au contrôle SiteMapPath en substituant la méthode InitializeItem. Le contrôle DropDownSiteMapPath ajoute un DropDownList après le nœud actuel afin de faciliter la navigation dans les pages qui sont des nœuds enfants de la page actuelle. Cet exemple montre comment utiliser les objets SiteMapNodeItem, y compris la vérification de leurs SiteMapNodeItemType et l'appel de la méthode OnItemCreated après que les éléments soient créés.


using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;


// The DropDownNavigationPath is a class that extends the SiteMapPath
// control and renders a DropDownList after the CurrentNode. The
// DropDownList displays a list of pages found further down the site map
// hierarchy from the current one. Selecting an item in the DropDownList
// redirects to that page.
//
// For simplicity, the DropDownNavigationPath assumes the
// RootToCurrent PathDirection, and does not apply styles
// or templates the current node.
//
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class DropDownNavigationPath : SiteMapPath {
    // Override the InitializeItem method to add a PathSeparator
    // and DropDownList to the current node.
    protected override void InitializeItem(SiteMapNodeItem item) {

        // The only node that must be handled is the CurrentNode.
        if (item.ItemType == SiteMapNodeItemType.Current)
        {
            HyperLink hLink = new HyperLink();

            // No Theming for the HyperLink.
            hLink.EnableTheming = false;
            // Enable the link of the SiteMapPath is enabled.
            hLink.Enabled = this.Enabled;

            // Set the properties of the HyperLink to
            // match those of the corresponding SiteMapNode.
            hLink.NavigateUrl = item.SiteMapNode.Url;
            hLink.Text        = item.SiteMapNode.Title;
            if (ShowToolTips) {
                hLink.ToolTip = item.SiteMapNode.Description;
            }

            // Apply styles or templates to the HyperLink here.
            // ...
            // ...

            // Add the item to the Controls collection.
            item.Controls.Add(hLink);

            AddDropDownListAfterCurrentNode(item);
        }
        else {
            base.InitializeItem(item);
        }
    }
    private void AddDropDownListAfterCurrentNode(SiteMapNodeItem item) {

        SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

        // Only do this work if there are child nodes.
        if (childNodes != null) {

            // Add another PathSeparator after the CurrentNode.
            SiteMapNodeItem finalSeparator =
                new SiteMapNodeItem(item.ItemIndex,
                                    SiteMapNodeItemType.PathSeparator);

            SiteMapNodeItemEventArgs eventArgs =
                new SiteMapNodeItemEventArgs(finalSeparator);

            InitializeItem(finalSeparator);
            // Call OnItemCreated every time a SiteMapNodeItem is
            // created and initialized.
            OnItemCreated(eventArgs);

            // The pathSeparator does not bind to any SiteMapNode, so
            // do not call DataBind on the SiteMapNodeItem.
            item.Controls.Add(finalSeparator);

            // Create a DropDownList and populate it with the children of the
            // CurrentNode. There are no styles or templates that are applied
            // to the DropDownList control. If OnSelectedIndexChanged is raised,
            // the event handler redirects to the page selected.
            // The CurrentNode has child nodes.
            DropDownList ddList = new DropDownList();
            ddList.AutoPostBack = true;

            ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

            // Add a ListItem to the DropDownList for every node in the
            // SiteMapNodes collection.
            foreach (SiteMapNode node in childNodes) {
                ddList.Items.Add(new ListItem(node.Title, node.Url));
            }

            item.Controls.Add(ddList);
        }
    }

    // The sender is the DropDownList.
    private void DropDownNavPathEventHandler(object sender,EventArgs e) {
        DropDownList ddL = sender as DropDownList;

        // Redirect to the page the user chose.
        if (Context != null)
            Context.Response.Redirect(ddL.SelectedValue);
    }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft