SiteMapDataSource.StartingNodeOffset Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een positief of negatief geheel getal op van het beginknooppunt dat de hoofdhiërarchie bepaalt die wordt weergegeven door het besturingselement voor de gegevensbron.
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 IntegerWaarde van eigenschap
De standaardwaarde is 0, wat aangeeft dat de hoofdhiërarchie die door de SiteMapDataSource hiërarchie wordt weergegeven, hetzelfde is als het beginknooppunt.
Voorbeelden
In het volgende codevoorbeeld ziet u het effect van de StartingNodeUrl en StartingNodeOffset eigenschappen. Het voorbeeld bestaat uit verschillende ASP.NET pagina's, een basispagina, de sectie basispagina en een web.sitemapbestand. Het bestand Web.sitemap definieert de hiërarchische structuur van de site. In dit codevoorbeeld worden een aantal pagina's gedefinieerd die worden geïdentificeerd door unieke URL's, zoals 1.aspx, 2.aspx, A.aspx en B.aspx, als volgt:
De pagina Site.master bevat de SiteMapDataSource en een TreeView besturingselementen in een ContentPlaceHolder besturingselement. Hiermee wordt het beginknooppunt van de weergegeven hiërarchie geïdentificeerd als Default.aspx, met behulp van de StartingNodeUrl eigenschap. Het bestand Site.master wordt alleen door de Default.aspx pagina gebruikt.
Op alle andere pagina's, zoals 1.aspx, 2.aspx, A.aspx, enzovoort, gebruikt u de hoofdpagina section.master. Deze basispagina is vergelijkbaar met Site.master, maar bevat verschillende SiteMapDataSource besturingselementen waarmee u kunt experimenteren. Het TreeView besturingselement waarmee siteoverzichtgegevens worden weergegeven, is in eerste instantie gebonden aan SiteMapDataSource1, waarmee een StartingNodeOffset van 1 wordt opgegeven. Dit geeft aan dat het bovenliggende knooppunt van de momenteel aangevraagde pagina wordt weergegeven. Als u pagina 1.aspx bekijkt, wordt de hiërarchie weergegeven door A TreeView , 1, 2. Als u echter pagina-4.aspx bekijkt, is de hiërarchie B, 3, 4.
Als u het voor de DataSourceIDTreeViewSiteMapDataSource2optie wijzigt, worden in het TreeView besturingselement siteoverzichtsgegevens anders weergegeven. Wanneer u de eigenschap gebruikt SiteMapDataSource2, wordt de StartFromCurrentNode eigenschap ingesteld op true, wat betekent dat de siteoverzichtgegevens worden weergegeven ten opzichte van de momenteel aangevraagde pagina en dat de StartingNodeOffset eigenschap is ingesteld op -1, wat aangeeft dat één niveau van onderliggende knooppunten wordt weergegeven, indien mogelijk. Wanneer u de A.aspx pagina bekijkt, is de weergegeven hiërarchie de hiërarchie van het huidige niveau, inclusief alle broers en zussen, zoals B en C. Wanneer u 1.aspx bekijkt, worden de bovenliggende knooppunten niet meer weergegeven.
In het volgende codevoorbeeld ziet u een van de ASP.NET pagina's die u kunt gebruiken met de andere onderdelen van dit codevoorbeeld.
<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
<h2>1.aspx</h2>
</asp:Content>
Opmerkingen
Als de StartingNodeOffset eigenschap is ingesteld op een andere waarde dan 0, is dit van invloed op het beginknooppunt en daarmee de siteoverzichtgegevenshiërarchie die door het SiteMapDataSource besturingselement wordt weergegeven. De negatieve of positieve gehele waarde van het StartingNodeOffset getal identificeert het aantal niveaus omhoog of omlaag van de siteoverzichthiërarchie van het beginknooppunt dat wordt geïdentificeerd door de StartFromCurrentNode en StartingNodeUrl eigenschappen om het beginknooppunt van de substructuur te compenseren die wordt weergegeven door gegevensbronbeheer.
Als het geïdentificeerde beginknooppunt het knooppunt is dat de momenteel aangevraagde pagina vertegenwoordigt, wordt het StartingNodeOffset genegeerd.
Als de StartingNodeOffset eigenschap is ingesteld op een negatief getal -n, is het beginknooppunt van de substructuur die wordt weergegeven door het besturingselement voor de gegevensbron het bovenliggende knooppunt n hiërarchische niveaus boven het geïdentificeerde beginknooppunt. Als de waarde n groter is dan het aantal bovenliggende niveaus in de hiërarchische structuur, is het beginknooppunt van de substructuur het hoofdknooppunt van de siteoverzichthiërarchie.
Als de StartingNodeOffset eigenschap is ingesteld op een positief getal +n, is het beginknooppunt van de weergegeven substructuur een onderliggend knooppunt n niveaus onder het geïdentificeerde beginknooppunt. Omdat er meer dan één vertakking van onderliggende knooppunten in de hiërarchie bestaat, SiteMapDataSource wordt geprobeerd een onderliggend knooppunt rechtstreeks op het pad tussen het geïdentificeerde beginknooppunt en het knooppunt dat de momenteel aangevraagde pagina vertegenwoordigt, indien mogelijk op te lossen. Als het knooppunt dat de momenteel aangevraagde pagina vertegenwoordigt zich niet in de substructuur van het geïdentificeerde beginknooppunt bevindt, wordt de waarde van de StartingNodeOffset eigenschap genegeerd. Als het knooppunt dat de momenteel aangevraagde pagina vertegenwoordigt, kleiner is dan n niveaus onder het geïdentificeerde beginknooppunt, wordt het momenteel aangevraagde paginaknooppunt gebruikt als het beginknooppunt.
De waarde van de StartingNodeOffset eigenschap wordt opgeslagen in de weergavestatus.
