SiteMapDataSource.StartingNodeOffset Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví kladný nebo záporný celočíselný posun od počátečního uzlu, který určuje kořenovou hierarchii, která je vystavena ovládací prvek zdroje dat.
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 IntegerHodnota vlastnosti
Výchozí hodnota je 0, což označuje, že kořenová hierarchie vystavená nástrojem SiteMapDataSource je stejná jako počáteční uzel.
Příklady
Následující příklad kódu ukazuje účinek StartingNodeUrl vlastností a StartingNodeOffset . Příklad se skládá z několika ASP.NET stránek, stránky předlohy, oddílu stránky předlohy a souboru Web.sitemap. Soubor Web.sitemap definuje hierarchickou strukturu webu. V tomto příkladu kódu definuje počet stránek identifikovaných jedinečnými adresami URL, například 1.aspx, 2.aspx, A.aspx a B.aspx, následujícím způsobem:
Stránka Site.master obsahuje SiteMapDataSource ovládací prvky a TreeView uvnitř ContentPlaceHolder ovládacího prvku. Pomocí vlastnosti identifikuje počáteční uzel vystavené hierarchie jako Default.aspx StartingNodeUrl . Soubor Site.master používá jenom stránka Default.aspx.
Všechny ostatní stránky, například 1.aspx, 2.aspx, A.aspx atd., používají stránku předlohy Section.master. Tato stránka předlohy se velmi podobá site.master, ale obsahuje několik SiteMapDataSource ovládacích prvků, se kterými můžete experimentovat. Ovládací TreeView prvek, který zobrazuje data mapy webu, je zpočátku svázán s SiteMapDataSource1parametrem StartingNodeOffset , který určuje 1. To znamená, že se zobrazí nadřazený uzel aktuálně požadované stránky. Pokud zobrazíte stránku 1.aspx, zobrazí se hierarchie TreeView A, 1, 2. Pokud ale zobrazíte stránku 4.aspx, hierarchie je B, 3, 4.
Pokud změníte DataSourceID pro pro TreeView na SiteMapDataSource2, TreeView ovládací prvek zobrazí data mapy webu odlišně. Při použití SiteMapDataSource2StartFromCurrentNode je vlastnost nastavena na true, což znamená, že data mapy webu se zobrazují vzhledem k aktuálně požadované stránce a StartingNodeOffset vlastnost je nastavená na hodnotu -1, což označuje, že se zobrazí jedna úroveň podřízených uzlů, pokud je to možné. Když zobrazíte stránku A.aspx, zobrazí se hierarchie aktuální úrovně, včetně všech sourozenců, například B a C. Při zobrazení 1.aspx se už nezobrazují nadřazené uzly.
Následující příklad kódu ukazuje jednu z ASP.NET stránek, které můžete použít s ostatními komponentami tohoto příkladu kódu.
<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
<h2>1.aspx</h2>
</asp:Content>
Poznámky
StartingNodeOffset Pokud je vlastnost nastavená na jinou hodnotu než 0, ovlivní to počáteční uzel a s ním i hierarchii dat mapy lokality, kterou ovládací prvek vystavujeSiteMapDataSource. Záporná nebo kladná celočíselná hodnota StartingNodeOffset určuje počet úrovní nahoru nebo dolů v hierarchii mapy webu od počátečního uzlu, který je identifikován vlastnostmi StartFromCurrentNode a StartingNodeUrl , aby se odsadil počáteční uzel podstromu, který je vystaven ovládacím prvek zdroje dat.
Pokud je identifikovaným počátečním uzlem uzel, který představuje aktuálně požadovanou stránku, StartingNodeOffset bude ignorován.
StartingNodeOffset Pokud je vlastnost nastavena na záporné číslo -n, je počátečním uzlem podstromu, který je zpřístupněn správou zdrojů dat, nadřazený uzel n hierarchických úrovní nad identifikovaným počátečním uzlem. Pokud je hodnota n větší než počet nadřazených úrovní v hierarchickém stromu, je počátečním uzlem podstromu kořenový uzel hierarchie mapy lokality.
StartingNodeOffset Pokud je vlastnost nastavena na kladné číslo +n, počáteční uzel podstromu, který je vystaven, je podřízený uzel n úrovní pod určeným počátečním uzlem. Vzhledem k tomu, že v hierarchii může existovat více než jedna větev podřízených uzlů, SiteMapDataSource pokusy o překlad podřízeného uzlu přímo na cestě mezi identifikovaným počátečním uzlem a uzlem, který představuje aktuálně požadovanou stránku, pokud je to možné. Pokud uzel, který představuje aktuálně požadovanou stránku, není v podstromu identifikovaného počátečního StartingNodeOffset uzlu, hodnota vlastnosti se ignoruje. Pokud je uzel, který představuje aktuálně požadovanou stránku, menší než n úrovní pod identifikovaným počátečním uzlem, použije se jako počáteční uzel aktuálně požadovaný uzel stránky.
Hodnota vlastnosti je uložena StartingNodeOffset ve stavu zobrazení.
