Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

SiteMapDataSource, classe

Fournit un contrôle de source de données que les contrôles serveur Web et d'autres contrôles peuvent utiliser pour se lier aux données de plan de site hiérarchiques.

System.Object
  System.Web.UI.Control
    System.Web.UI.HierarchicalDataSourceControl
      System.Web.UI.WebControls.SiteMapDataSource

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

[ToolboxBitmapAttribute(typeof(SiteMapDataSource))]
public class SiteMapDataSource : HierarchicalDataSourceControl, 
	IDataSource, IListSource
<asp:SiteMapDataSource />

Le type SiteMapDataSource expose les membres suivants.

  NomDescription
Méthode publiqueSiteMapDataSourceInitialise une nouvelle instance de la classe SiteMapDataSource.
Début

  NomDescription
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é publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
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'identificateur de contrôle serveur généré par ASP.NET. (Hérité de HierarchicalDataSourceControl.)
Propriété publiqueClientIDModeCette propriété n'est pas utilisée pour les contrôles de source de données. (Hérité de HierarchicalDataSourceControl.)
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é publiqueContainsListCollectionObtient une valeur qui indique si le contrôle de source de données contient une collection d'objets de vue de source de données.
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 d'un contrôle serveur spécifié dans la hiérarchie de l'interface utilisateur. (Hérité de HierarchicalDataSourceControl.)
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é publiqueEnableThemingObtient une valeur indiquant si cet objet prend en charge des thèmes. (Hérité de HierarchicalDataSourceControl.)
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é 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é 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é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é 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é publiqueProviderObtient ou définit un objet SiteMapProvider associé au contrôle de source de données.
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é publiqueShowStartingNodeObtient ou définit une valeur qui indique si le nœud de démarrage est récupéré et affiché.
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 fournisseur de plan de site auquel la source de données est liée.
Propriété publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle HierarchicalDataSourceControl. (Hérité de HierarchicalDataSourceControl.)
Propriété publiqueStartFromCurrentNodeObtient ou définit une valeur qui indique si l'arborescence de nœuds de plan de site est récupérée à l'aide du nœud représentant la page actuelle.
Propriété publiqueStartingNodeOffsetObtient ou définit un offset entier positif ou négatif du nœud de démarrage qui détermine la hiérarchie racine exposée par le contrôle de source de données.
Propriété publiqueStartingNodeUrlObtient ou définit un nœud dans le plan de site que la source de données utilise comme point de référence pour récupérer des nœuds d'un plan de site hiérarchique.
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é publiqueUniqueIDObtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (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 indiquant l'affichage visuel ou non du contrôle. (Hérité de HierarchicalDataSourceControl.)
Début

  NomDescription
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 publiqueApplyStyleSheetSkinApplique les propriétés de style qui sont définies dans la feuille de style de la page au contrôle. (Hérité de HierarchicalDataSourceControl.)
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 protégéeCreateChildControlsAppelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.)
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 HierarchicalDataSourceControl.)
Méthode publiqueDataBind()Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
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é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'Object spécifié est égal à l'Object en cours. (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 HierarchicalDataSourceControl.)
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 publiqueFocusDéfinit le focus d'entrée sur le contrôle. (Hérité de HierarchicalDataSourceControl.)
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 pour un type particulier. (Hérité de Object.)
Méthode protégéeGetHierarchicalViewRécupère une vue unique des données de plan de site pour l'objet SiteMapProvider en fonction du nœud de démarrage et d'autres propriétés de la source de données. (Substitue HierarchicalDataSourceControl.GetHierarchicalView(String).)
Méthode publiqueGetListRécupère la liste des contrôles de source de données qui peuvent être utilisés comme sources de listes de données.
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 publiqueGetViewRécupère une vue nommée des données de plan de site du fournisseur de plan de site en fonction du nœud de démarrage et d'autres propriétés de la source de données.
Méthode publiqueGetViewNamesRécupère une collection de vues nommées pour le contrôle de source de données.
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de HierarchicalDataSourceControl.)
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é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 demande de page antérieure enregistrée par la méthode SaveViewState. (Hérité de Control.)
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 actif. (Hérité de Object.)
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éeOnDataBindingDéclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégéeOnDataSourceChangedDéclenche l'événement DataSourceChanged. (Hérité de HierarchicalDataSourceControl.)
Méthode protégéeOnInitDéclenche l'événement Init. (Hérité de Control.)
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é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éeRenderEnvoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
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 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 HierarchicalDataSourceControl.)
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 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éeSaveViewStateEnregistre les modifications éventuellement apportées à l'état d'affichage du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.)
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 publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégéeTrackViewStateProvoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété Control.ViewState. (Hérité de Control.)
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 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.)
Méthode d'extension publiqueGetDefaultValuesObtient la collection des valeurs par défaut pour la source de données spécifiée. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueGetMetaTableObtient les métadonnées pour une table dans l'objet source de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueTryGetMetaTableDétermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début

  NomDescription
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 expliciteÉvénement privéIDataSource.DataSourceChangedInfrastructure. Se produit lorsque la modification d'un contrôle de source de données affecte les contrôles liés aux données.
Implémentation d'interface expliciteMéthode privéeIDataSource.GetViewInfrastructure. Pour une description de ce membre, consultez GetView.
Implémentation d'interface expliciteMéthode privéeIDataSource.GetViewNamesInfrastructure. Pour obtenir une description de ce membre, consultez GetViewNames.
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 expliciteÉvénement privéIHierarchicalDataSource.DataSourceChangedInfrastructure. Se produit lorsque HierarchicalDataSourceControl a changé d'une façon qui affecte les contrôles liés aux données. (Hérité de HierarchicalDataSourceControl.)
Implémentation d'interface expliciteMéthode privéeIHierarchicalDataSource.GetHierarchicalViewInfrastructure. Obtient l'objet d'assistance à l'affichage de l'interface IHierarchicalDataSource pour le chemin d'accès spécifié. (Hérité de HierarchicalDataSourceControl.)
Implémentation d'interface explicitePropriété privéeIListSource.ContainsListCollectionInfrastructure. Obtient une valeur qui indique si la collection est une collection d'objets IList.
Implémentation d'interface expliciteMéthode privéeIListSource.GetListInfrastructure. Pour une description de ce membre, consultez GetList.
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 SiteMapDataSource est une source de données pour les données de plan de site stockées par les fournisseurs de plan de site configurés pour votre site. SiteMapDataSource active les contrôles serveur Web qui ne sont pas spécifiquement des contrôles de navigation de site, tels que les contrôles TreeView, Menu et DropDownList, à lier aux données de plan de site hiérarchiques. Vous pouvez utiliser ces contrôles serveur Web pour afficher un plan de site sous forme de table des matières ou parcourir activement un site. Une autre possibilité consiste à utiliser le contrôle SiteMapPath, qui est conçu spécifiquement comme un contrôle de navigation de site, et qui, par conséquent, n'a pas besoin d'une instance du contrôle SiteMapDataSource.

Spécification du nœud initial

Le SiteMapDataSource se lie aux données de plan de site et présente sa vue en fonction d'un nœud de démarrage spécifié dans la hiérarchie de plan de site. Par défaut, ce nœud correspond au nœud racine de la hiérarchie, mais il peut également s'agir d'un autre nœud dans la hiérarchie. Le nœud de démarrage est identifié par les valeurs de plusieurs propriétés SiteMapDataSource comme suit :

Nœud de démarrage

Valeurs de la propriété

Nœud racine de la hiérarchie (paramètre par défaut).

Le StartFromCurrentNode est false.

StartingNodeUrl n'est pas défini.

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

Le StartFromCurrentNode est true.

StartingNodeUrl n'est pas défini.

Nœud spécifique de la hiérarchie.

Le StartFromCurrentNode est false.

StartingNodeUrl n'est pas défini.

Si la propriété StartingNodeOffset a une valeur autre que 0, elle affecte le nœud de démarrage ainsi que la hiérarchie des données de plan de site qui est exposée par le contrôle SiteMapDataSource. La valeur entière négative ou positive de StartingNodeOffset identifie le nombre de niveaux supérieurs ou inférieurs dans la hiérarchie de plan de site du nœud démarrage qui est identifié par les propriétés StartFromCurrentNode et StartingNodeUrl pour définir un offset du nœud démarrage du sous-arbre qui est exposé par le contrôle de source de données.

Si la propriété StartingNodeOffset a la valeur d'un nombre négatif -n, le nœud de démarrage du sous-arbre qui est exposé par le contrôle de source de données est le nœud ancêtre, n niveaux hiérarchiques au-dessus du nœud de démarrage identifié. Si la valeur n est supérieure au nombre de niveaux ancêtres dans l'arborescence hiérarchique, le nœud de démarrage du sous-arbre correspond au nœud racine de la hiérarchie de plan de site.

Si la propriété StartingNodeOffset a la valeur d'un nombre positif +n, le nœud de démarrage du sous-arbre qui est exposé est un nœud enfant, n niveaux au-dessous du nœud de démarrage identifié. Étant donné que plusieurs branches de nœuds enfants peuvent exister dans la hiérarchie, SiteMapDataSource essaie de trouver directement un nœud enfant sur le chemin d'accès entre le nœud de démarrage identifié et le nœud qui représente la page actuellement demandée, si possible. Si le nœud qui représente la page actuellement demandée n'est pas présent dans le sous-arbre du nœud de démarrage identifié, la valeur de la propriété StartingNodeOffset est ignorée. Si le nœud qui représente la page actuellement demandée est moins de n niveaux au-dessous du nœud de démarrage identifié, le nœud de la page actuellement demandée est utilisé comme nœud de démarrage.

Extraction de données de plan de site

Les données de plan de site sont extraites d'un objet SiteMapProvider, tel que XmlSiteMapProvider, qui est le fournisseur de plan de site par défaut pour ASP.NET. Vous pouvez spécifier n'importe quel fournisseur configuré pour votre site pour fournir les données du plan de site à la SiteMapDataSource et obtenir la liste des fournisseurs disponibles en accédant à la collection SiteMap.Providers.

Comme tous les contrôles de source de données, chaque instance de SiteMapDataSource est associée à un objet d'assistance unique appelé vue de la source de données. D'après les propriétés de la source de données, SiteMapDataSourceView est une vue des données de plan de site, qui est récupérée en appelant la méthode GetHierarchicalView. SiteMapDataSourceView gère l'objet SiteMapNodeCollection auquel les contrôles sont liés.

Par défaut, le nœud de démarrage correspond au nœud racine de la hiérarchie, mais vous pouvez le définir sur un autre nœud. Le point de départ peut être un nœud relatif à la position actuelle dans le plan de site ou à une position absolue. Vous pouvez spécifier le nœud de démarrage en définissant la propriété StartingNodeUrl.

SiteMapDataSource est spécialisé pour les données de navigation, et ne prend pas en charge les opérations de source de données courantes, telles que le tri, le filtrage, la pagination ou la mise en cache, ou encore les opérations d'enregistrement de données, telles que les mises à jour, les insertions ou les suppressions.

Syntaxe déclarative

<asp:SiteMapDataSource
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    ShowStartingNode="True|False"
    SiteMapProvider="string"
    SkinID="string"
    StartFromCurrentNode="True|False"
    StartingNodeOffset="integer"
    StartingNodeUrl="uri"
    Visible="True|False"
/>
TopicLocation
Procédure pas à pas : contrôle des menus ASP.NET par programmeGé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 Web ASP.NET dans Visual Studio
Procédure pas à pas : filtrage des nœuds sitemap en fonction des rôles de sécuritéGé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
Procédure pas à pas : filtrage des nœuds sitemap en fonction des rôles de sécuritéGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : contrôle des menus ASP.NET par programmeGé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
Procédure pas à pas : filtrage des nœuds sitemap en fonction des rôles de sécuritéGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : contrôle des menus ASP.NET par programmeGé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 : localiser les données sitemapGénération d'applications Web ASP.NET

L'exemple de code suivant montre comment lier de façon déclarative un contrôle TreeView à un plan de site à l'aide d'un contrôle SiteMapDataSource. Les données de plan de site sont récupérées en commençant au niveau du nœud racine.


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

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

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

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


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.
Afficher: