SiteMapDataSource.StartingNodeOffset Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

public:
 virtual property int StartingNodeOffset { int get(); void set(int value); };
public virtual int StartingNodeOffset { get; set; }
member this.StartingNodeOffset : int with get, set
Public Overridable Property StartingNodeOffset As Integer

Valeur de propriété

Int32

La valeur par défaut est 0 qui indique que la hiérarchie racine exposée par SiteMapDataSource est la même que le nœud de démarrage.

Exemples

L’exemple de code suivant illustre l’effet des StartingNodeUrl propriétés et StartingNodeOffset . L’exemple se compose de plusieurs pages ASP.NET, d’une page maître, d’une section de page maître et d’un fichier Web.sitemap. Le fichier Web.sitemap définit la structure hiérarchique du site. Pour cet exemple de code, il définit un certain nombre de pages identifiées par des URL uniques, telles que 1.aspx, 2.aspx, A.aspx et B.aspx, comme suit :

La page Site.master contient les SiteMapDataSource contrôles et à TreeView l’intérieur d’un ContentPlaceHolder contrôle. Il identifie le nœud de départ de la hiérarchie exposée comme Default.aspx, à l’aide de la StartingNodeUrl propriété . Le fichier Site.master est utilisé par la page Default.aspx uniquement.

Toutes les autres pages, telles que 1.aspx, 2.aspx, A.aspx, etc., utilisent la page maître Section.master. Cette page maître est très similaire à Site.master, mais elle contient plusieurs SiteMapDataSource contrôles que vous pouvez expérimenter. Le TreeView contrôle qui affiche les données de plan de site est initialement lié à SiteMapDataSource1, ce qui spécifie une StartingNodeOffset valeur de 1. Cela indique que le nœud parent de la page actuellement demandée s’affiche. Si vous affichez la page 1.aspx, la hiérarchie affichée par est TreeView A, 1, 2. Toutefois, si vous affichez la page 4.aspx, la hiérarchie est B, 3, 4.

Si vous remplacez par DataSourceIDTreeViewSiteMapDataSource2, le contrôle affiche les TreeView données de plan de site différemment. Lorsque vous utilisez SiteMapDataSource2, la propriété a la StartFromCurrentNode valeur true, ce qui signifie que les données de plan de site sont affichées par rapport à la page actuellement demandée et que la propriété a la StartingNodeOffset valeur -1, ce qui indique qu’un niveau de nœuds enfants est affiché, si possible. Lorsque vous affichez la page A.aspx, la hiérarchie affichée est la hiérarchie du niveau actuel, y compris tous les frères, tels que B et C. Lorsque vous affichez 1.aspx, les nœuds parents ne sont plus affichés.

L’exemple de code suivant illustre l’une des pages ASP.NET que vous pouvez utiliser avec les autres composants de cet exemple de code.

<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>  

<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>  
  <h2>1.aspx</h2>  
</asp:Content>

Remarques

Si la StartingNodeOffset propriété est définie sur une valeur autre que 0, cela affecte le nœud de départ et avec lui la hiérarchie de données de plan de site exposée par le SiteMapDataSource contrôle. La valeur entière négative ou positive du 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épart identifié par les StartFromCurrentNode propriétés et StartingNodeUrl pour décaler le nœud de départ de la sous-arborescence exposée par le contrôle de source de données.

Si le nœud de départ identifié est le nœud qui représente la page actuellement demandée, le StartingNodeOffset est ignoré.

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

Si la StartingNodeOffset propriété est définie sur un nombre positif +n, le nœud de départ de la sous-arborescence exposée est un nœud enfant n niveaux sous le nœud de départ identifié. Étant donné que plusieurs branches de nœuds enfants peuvent exister dans la hiérarchie, les SiteMapDataSource tentatives de résolution d’un nœud enfant directement sur le chemin entre le nœud de départ 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 ne se trouve pas dans la sous-arborescence du nœud de départ 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érieur à n niveaux sous le nœud de départ identifié, le nœud de page actuellement demandé est utilisé comme nœud de départ.

La valeur de la StartingNodeOffset propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi