Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SiteMapDataSource classe

 

Date de publication : novembre 2016

Fournit un contrôle de source de données que les contrôles serveur web et d’autres contrôles peuvent utiliser pour établir une liaison à des données de plan de site hiérarchique.

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

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

[ToolboxBitmapAttribute(typeof(SiteMapDataSource))]
public class SiteMapDataSource : HierarchicalDataSourceControl, 
	IDataSource, IListSource

NomDescription
System_CAPS_pubmethodSiteMapDataSource()

Initialise une nouvelle instance de la classe SiteMapDataSource.

NomDescription
System_CAPS_protpropertyAdapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application de la Page ou UserControl objet qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyBindingContainer

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le contrôle qui contient la liaison de données de ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.(Hérité de Control.)

System_CAPS_pubpropertyClientID

Obtient l’identificateur du contrôle serveur généré par ASP.NET.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyClientIDMode

Cette propriété n’est pas utilisée pour les contrôles de source de données.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protpropertyClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans le ClientID propriété.(Hérité de Control.)

System_CAPS_pubpropertyContainsListCollection

Obtient une valeur indiquant si le contrôle de source de données contient une collection d’objets de vue de source de données.

System_CAPS_protpropertyContext

Obtient le HttpContext est associé au contrôle serveur pour la demande Web actuelle.(Hérité de Control.)

System_CAPS_pubpropertyControls

Obtient un ControlCollection objet 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.)

System_CAPS_pubpropertyDataItemContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataItemContainer.(Hérité de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataKeysControl.(Hérité de Control.)

System_CAPS_protpropertyDesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertyEnableTheming

Obtient une valeur indiquant si ce contrôle prend en charge les thèmes.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyEnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.(Hérité de Control.)

System_CAPS_protpropertyEvents

Obtient une liste de délégués de gestionnaires d’événements pour le contrôle. Cette propriété est en lecture seule.(Hérité de Control.)

System_CAPS_protpropertyHasChildViewState

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur actuel ont tous les paramètres d’état d’affichage enregistrés.(Hérité de Control.)

System_CAPS_pubpropertyID

Obtient ou définit l’identificateur programmatique assigné au contrôle serveur.(Hérité de Control.)

System_CAPS_protpropertyIdSeparator

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le caractère utilisé pour séparer les identificateurs de contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtient une valeur qui indique si les contrôles contenus dans ce contrôle ont état du contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.(Hérité de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index.(Hérité de Control.)

System_CAPS_pubpropertyNamingContainer

Obtient une référence au contrôle de serveur de noms de conteneur, ce qui crée un espace de noms unique pour différencier les contrôles serveur avec le même Control.ID valeur de propriété.(Hérité de Control.)

System_CAPS_pubpropertyPage

Obtient une référence à la Page instance qui contient le contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyParent

Obtient une référence au contrôle parent du contrôle de serveur dans la hiérarchie de contrôle de page.(Hérité de Control.)

System_CAPS_pubpropertyProvider

Obtient ou définit un SiteMapProvider objet qui est associé au contrôle de source de données.

System_CAPS_pubpropertyRenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET HTML restitué sera compatible avec.(Hérité de Control.)

System_CAPS_pubpropertyShowStartingNode

Obtient ou définit une valeur indiquant si le nœud de démarrage est récupéré et affiché.

System_CAPS_pubpropertySite

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertySiteMapProvider

Obtient ou définit le nom du fournisseur de plan de site qui crée une liaison à la source de données.

System_CAPS_pubpropertySkinID

Obtient ou définit l’apparence à appliquer à la HierarchicalDataSourceControl contrôle.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyStartFromCurrentNode

Obtient ou définit une valeur qui indique si l’arborescence de nœuds de plan de site est récupérée en utilisant le nœud qui représente la page actuelle.

System_CAPS_pubpropertyStartingNodeOffset

Obtient 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.

System_CAPS_pubpropertyStartingNodeUrl

Obtient 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 extraire des nœuds à partir d’un plan de site hiérarchiques.

System_CAPS_pubpropertyTemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtient le répertoire virtuel de le Page ou UserControl qui contient le contrôle serveur en cours.(Hérité de Control.)

System_CAPS_pubpropertyUniqueID

Obtient l’identificateur unique qualifié hiérarchiquement du contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie les entrées de client à partir du navigateur de valeurs potentiellement dangereuses.(Hérité de Control.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et restaurer l’état d’affichage d’un contrôle serveur entre plusieurs demandes de la même page.(Hérité de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtient une valeur qui indique si le StateBag objet respecte la casse.(Hérité de Control.)

System_CAPS_pubpropertyViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur indiquant si le contrôle est affiché visuellement.(Hérité de HierarchicalDataSourceControl.)

NomDescription
System_CAPS_protmethodAddedControl(Control, Int32)

Appelée après qu’un contrôle enfant est ajouté à la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifie au contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applique les propriétés de style qui sont définies dans la feuille de style de page pour le contrôle.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design de données de rendu.(Hérité de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Rassemble des informations sur le contrôle serveur, puis les remet à la Trace propriété à afficher lorsque le traçage est activé pour la page.(Hérité de Control.)

System_CAPS_protmethodClearCachedClientID()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la mise en cache ClientID valeur null.(Hérité de Control.)

System_CAPS_protmethodClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodClearChildState()

Supprime les informations d’état d’affichage et état du contrôle pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearChildViewState()

Supprime les informations d’état d’affichage pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le ClientIDMode propriété de l’instance actuelle du contrôle et de ses contrôles enfants à Inherit.(Hérité de Control.)

System_CAPS_protmethodCreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.(Hérité de Control.)

System_CAPS_protmethodCreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubmethodDataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodDataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher la DataBinding événement.(Hérité de Control.)

System_CAPS_protmethodDataBindChildren()

Lie une source de données à des contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodDispose()

Permet à un contrôle serveur effectuer de nettoyage final avant qu’il est libéré de la mémoire.(Hérité de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Se termine au moment du design le suivi des données de rendu.(Hérité de Control.)

System_CAPS_protmethodEnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si elle n’est pas le cas, il crée contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodEnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.(Hérité de Control.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

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.)

System_CAPS_pubmethodFindControl(String)

Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id paramètre.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodFindControl(String, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id et un entier, spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas substituer cette version de la FindControl méthode.(Hérité de Control.)

System_CAPS_pubmethodFocus()

Définit le focus d'entrée sur le contrôle.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodGetDesignModeState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_protmethodGetHierarchicalView(String)

Récupère une vue unique sur les données de plan de site pour le SiteMapProvider objet selon le nœud de démarrage et d’autres propriétés de la source de données.(Remplace HierarchicalDataSourceControl.GetHierarchicalView(String).)

System_CAPS_pubmethodGetList()

Récupère une liste de contrôles de source de données qui peuvent être utilisés comme sources de listes de données.

System_CAPS_pubmethodGetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodGetView(String)

Récupère une vue nommée sur les 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.

System_CAPS_pubmethodGetViewNames()

Récupère une collection de vues nommées pour le contrôle de source de données.

System_CAPS_pubmethodHasControls()

Détermine si le contrôle serveur contient des contrôles enfants.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodHasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou tous les contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodIsLiteralContent()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si le contrôle serveur détient uniquement un contenu littéral.(Hérité de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaure les informations d’état du contrôle à partir d’une demande de page précédente enregistrée par la SaveControlState méthode.(Hérité de Control.)

System_CAPS_protmethodLoadViewState(Object)

Restaure les informations d’état d’affichage d’une demande de page précédente enregistrée par la SaveViewState méthode.(Hérité de Control.)

System_CAPS_protmethodMapPathSecure(String)

Récupère le chemin d’accès physique correspondant à un chemin d’accès virtuel, absolu ou relatif.(Hérité de Control.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.(Hérité de Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Déclenche l'événement DataBinding.(Hérité de Control.)

System_CAPS_protmethodOnDataSourceChanged(EventArgs)

Déclenche l'événement DataSourceChanged.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodOnInit(EventArgs)

Déclenche l'événement Init.(Hérité de Control.)

System_CAPS_protmethodOnLoad(EventArgs)

Déclenche l'événement Load.(Hérité de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Déclenche l'événement PreRender.(Hérité de Control.)

System_CAPS_protmethodOnUnload(EventArgs)

Déclenche l'événement Unload.(Hérité de Control.)

System_CAPS_protmethodOpenFile(String)

Obtient un Stream utilisé pour lire un fichier.(Hérité de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assigne toute source de l’événement et ses informations au parent du contrôle.(Hérité de Control.)

System_CAPS_protmethodRemovedControl(Control)

Appelée après qu’un contrôle enfant est supprimé de la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Renvoie le contenu des enfants d’un contrôle serveur à une collection HtmlTextWriter objet, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter à l’aide d’un ControlAdapter objet.(Hérité de Control.)

System_CAPS_protmethodResolveAdapter()

Obtient l’adaptateur de contrôles responsable du rendu du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.(Hérité de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convertit une URL qui est utilisable sur le client demandeur.(Hérité de Control.)

System_CAPS_protmethodSaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.(Hérité de Control.)

System_CAPS_protmethodSaveViewState()

Enregistre les changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur.(Hérité de Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Assigne un délégué de gestionnaire d’événements pour afficher le contrôle de serveur et son contenu dans son contrôle parent.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de l’objet de suivi, la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Provoque le suivi des modifications d’état d’affichage pour le contrôle serveur afin qu’elles puissent être stockées dans le contrôle de serveur StateBag objet. Cet objet est accessible via la propriété Control.ViewState.(Hérité de Control.)

NomDescription
System_CAPS_pubeventDataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.(Hérité de Control.)

System_CAPS_pubeventDisposed

Se produit lorsqu’un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie serveur contrôle lorsqu’une page ASP.NET est demandée.(Hérité de Control.)

System_CAPS_pubeventInit

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape du cycle de vie.(Hérité de Control.)

System_CAPS_pubeventLoad

Se produit lorsque le contrôle serveur est chargé dans le Page objet.(Hérité de Control.)

System_CAPS_pubeventPreRender

Se produit après le Control objet est chargé, mais avant le rendu.(Hérité de Control.)

System_CAPS_pubeventUnload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.(Hérité de Control.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_priveventIDataSource.DataSourceChanged

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Se produit lorsqu’un contrôle de source de données a changé d’une manière qui affecte des contrôles liés aux données.

System_CAPS_pubinterfaceSystem_CAPS_priveventIHierarchicalDataSource.DataSourceChanged

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Se produit lorsque la HierarchicalDataSourceControl a changé d’une manière qui affecte des contrôles liés aux données.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIListSource.GetList()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez GetList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetView(String)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez GetView.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetViewNames()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez GetViewNames.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIHierarchicalDataSource.GetHierarchicalView(String)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient l’objet d’assistance d’affichage pour le IHierarchicalDataSource interface pour le chemin d’accès spécifié.(Hérité de HierarchicalDataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIListSource.ContainsListCollection

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient une valeur qui indique si la collection est une collection de IList objets.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions.(Hérité de Control.)

NomDescription
System_CAPS_pubmethodFindDataSourceControl()

Retourne la source de données qui est associée au contrôle de données pour le contrôle spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retourne que le modèle de champ pour la colonne spécifiée dans le contrôle spécifié du conteneur de dénomination.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retourne l’objet metatable pour le contrôle de données conteneur.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Surchargé. Obtient la collection des valeurs par défaut pour la source de données spécifiée.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Surchargé. Obtient les métadonnées pour une table dans l’objet de source de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Surchargé. Détermine si les métadonnées de la table sont disponible.(Défini par DynamicDataExtensions.)

Le SiteMapDataSource contrôle 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. Le SiteMapDataSource permet aux contrôles serveur Web qui ne sont pas spécifiquement des contrôles de navigation de site, tels que le TreeView, Menu, et DropDownList contrôles, à lier aux données de plan de site hiérarchiques. Vous pouvez utiliser ces contrôles serveur Web pour afficher un plan de site en tant que table des matières ou parcourir activement un site. Vous pouvez également utiliser le SiteMapPath contrôle, qui est conçu spécifiquement comme un contrôle de navigation de site et ne nécessite donc pas une instance de la SiteMapDataSource contrôle.

Le SiteMapDataSource se lie aux données de plan de site et présente sa vue en fonction d’un nœud de départ spécifié dans la hiérarchie de plan de site. Par défaut, c’est le nœud racine de la hiérarchie, mais il peut également être n’importe quel nœud dans la hiérarchie. Le nœud de démarrage est identifié par les valeurs de plusieurs SiteMapDataSource propriétés comme suit :

Nœud de démarrage

Valeurs de propriété

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

StartFromCurrentNode a la valeur false.

Le StartingNodeUrl n’est pas définie.

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

StartFromCurrentNode a la valeur true.

Le StartingNodeUrl n’est pas définie.

Un nœud spécifique de la hiérarchie.

StartFromCurrentNode a la valeur false.

Le StartingNodeUrl est défini.

Si la StartingNodeOffset est définie sur une valeur autre que 0, elle affecte le nœud de départ et que le site de plan de hiérarchie de données qui est exposé par le SiteMapDataSource contrôle. La valeur entière positive ou négative de la StartingNodeOffset identifie le nombre de niveaux vers le haut ou vers le bas de la hiérarchie de plan de site à partir du nœud de démarrage qui est identifiée par le StartFromCurrentNode et StartingNodeUrl Propriétés pour le décalage du nœud de démarrage du sous-arbre qui est exposé par les données de contrôle de code source.

Si la StartingNodeOffset est définie sur 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. Si la valeur n est supérieure au nombre de niveaux ancêtres dans l’arborescence hiérarchique, le nœud de démarrage de la sous-arborescence du nœud racine de la hiérarchie de plan de site.

Si la StartingNodeOffset est définie sur un nombre positif +n, le nœud de démarrage du sous-arbre qui est exposé est un nœud enfant n en dessous du nœud de démarrage. Étant donné que plusieurs branches de nœuds enfants peuvent exister dans la hiérarchie, le SiteMapDataSource essaie de trouver un nœud enfant directement 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 dans la sous-arborescence du nœud de démarrage identifié, la valeur de la StartingNodeOffset propriété est ignorée. Si le nœud qui représente la page actuellement demandée est inférieure à n en 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.

Données de plan de site sont récupérées à partir d’un SiteMapProvider de l’objet, 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 de plan de site pour le SiteMapDataSource et obtenir la liste des fournisseurs disponibles en accédant à la SiteMap.Providers collection.

Comme tous les contrôles de source de données, chaque instance d’un SiteMapDataSource est associé à un objet d’assistance unique appelé comme une vue de source de données. Le SiteMapDataSourceView est une vue sur les données de plan de site, en fonction des propriétés de la source de données et est récupérée en appelant le GetHierarchicalView (méthode). Le SiteMapDataSourceView gère la SiteMapNodeCollection objet les contrôles sont liés.

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

Le 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, la mise en cache ou opérations d’enregistrement de données telles que les mises à jour, les insertions ou les suppressions.

<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"
/>

L’exemple de code suivant montre comment lier de façon déclarative un TreeView contrôle à une carte de site en utilisant un SiteMapDataSource contrôle. 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
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: