SiteMapDataSource.StartingNodeOffset Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Overridable Property StartingNodeOffset As IntegerValeur de propriété
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.plan du site. Le fichier Web.plan du site 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 tester. Le TreeView contrôle qui affiche les données de plan de site est initialement lié à SiteMapDataSource1, qui spécifie un StartingNodeOffset de 1. Cela indique que le nœud parent de la page actuellement demandée s’affiche. Si vous affichez des 1.aspx de page, la hiérarchie affichée par est TreeView A, 1, 2. Toutefois, si vous affichez des 4.aspx de page, la hiérarchie est B, 3, 4.
Si vous modifiez le DataSourceID pour sur SiteMapDataSource2TreeView , le TreeView contrôle affiche les données de plan de site différemment. Lorsque vous utilisez SiteMapDataSource2, la propriété a truela StartFromCurrentNode valeur , ce qui signifie que les données de plan de site sont affichées par rapport à la page actuellement demandée et que la StartingNodeOffset propriété est définie sur -1, ce qui indique qu’un niveau de nœuds enfants est affiché, lorsque cela est possible. Lorsque vous affichez la page A.aspx, la hiérarchie affichée correspond à la hiérarchie du niveau actuel, y compris tous les frères et sœurs, 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, elle affecte le nœud de départ et avec lui la hiérarchie de données de plan de site qui est 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 la carte 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, est StartingNodeOffset 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é qu’il peut exister plusieurs branches de nœuds enfants dans la hiérarchie, le SiteMapDataSource tente de résoudre 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.
