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 správou 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ž značí, že kořenová hierarchie vystavená SiteMapDataSource počátečním uzlem je stejná.
Příklady
Následující příklad kódu ukazuje účinek StartingNodeUrl a StartingNodeOffset vlastnosti. 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.mapa webu. Soubor Web.mapa webu definuje hierarchickou strukturu webu. V tomto příkladu kódu definuje řadu stránek identifikovaných jedinečnými adresami URL, jako jsou 1.aspx, 2.aspx, A.aspx a B.aspx, následujícím způsobem:
Stránka Site.master obsahuje ovládací SiteMapDataSource prvky uvnitř ContentPlaceHolder ovládacího prvku.TreeView Identifikuje počáteční uzel vystavené hierarchie jako Default.aspx pomocí StartingNodeUrl vlastnosti. Soubor Site.master používá pouze 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 je velmi podobná 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 původně vázán na SiteMapDataSource1, který určuje StartingNodeOffset 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 nastavení na TreeViewSiteMapDataSource2, TreeView ovládací prvek zobrazí data mapy webu odlišně. Při použití SiteMapDataSource2StartFromCurrentNode je vlastnost nastavena na truehodnotu , což znamená, že se data mapy webu zobrazí vzhledem k aktuálně požadované stránce a StartingNodeOffset vlastnost je nastavena na hodnotu -1, což znamená, že se zobrazí jedna úroveň podřízených uzlů, pokud je to možné. Při zobrazení stránky A.aspx je zobrazená hierarchie hierarchie aktuální úrovně, včetně všech prvků na stejné úrovni, jako je B a C. Když zobrazíte 1.aspx, nadřazené uzly se už nezobrazí.
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 nastavena na jinou hodnotu než 0, ovlivňuje počáteční uzel a s ní hierarchii dat mapy webu, která je vystavena ovládacím SiteMapDataSource prvku. Záporná nebo kladná celočíselná hodnota identifikuje počet úrovní nahoru nebo dolů v hierarchii mapy webu od počátečního uzlu, který je identifikován počátečním StartingNodeUrl nebo kladným StartFromCurrentNode celočíselnou hodnotouStartingNodeOffset, aby se odsadil počáteční uzel podstromu, který je vystavený správou zdrojů 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, počáteční uzel podstromu, který je vystaven ovládacím prvku zdroje dat, je nadřazený uzel n hierarchické ú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 webu.
StartingNodeOffset Pokud je vlastnost nastavena na kladné číslo +n, počáteční uzel podstromu, který je vystaven, je podřízený uzel n úrovní pod identifikovaný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 uzlu, hodnota StartingNodeOffset vlastnosti bude ignorována. 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 aktuálně požadovaný uzel stránky jako výchozí uzel.
Hodnota StartingNodeOffset vlastnosti je uložena ve stavu zobrazení.
