SiteMapDataSource.StartingNodeOffset Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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, set
Public Overridable Property StartingNodeOffset As Integer

Hodnota vlastnosti

Int32

Výchozí hodnota je 0, což znamená, ž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. Identifikuje počáteční uzel vystavené hierarchie jako Default.aspx pomocí StartingNodeUrl vlastnosti . Soubor Site.master je používán pouze stránkou 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 na začá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, hierarchie zobrazená pomocí TreeView je A, 1, 2. Pokud však zobrazíte stránku 4.aspx, hierarchie je B, 3, 4.

Pokud změníte DataSourceID pro na TreeViewSiteMapDataSource2, TreeView ovládací prvek zobrazí data mapy webu odlišně. Při použití příkazu SiteMapDataSource2StartFromCurrentNode je vlastnost nastavená na truehodnotu , což znamená, že se data mapy webu 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é. Při zobrazení stránky A.aspx je zobrazená hierarchie hierarchie aktuální úrovně, včetně všech úrovní na stejné úrovni, jako jsou 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 nastavena na jinou hodnotu než 0, ovlivní to počáteční uzel a tím i hierarchii dat mapy lokality, která je zpřístupněna ovládacím SiteMapDataSource prvek. 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 se ignorovat.

StartingNodeOffset Pokud je vlastnost nastavena na záporné číslo -n, počáteční uzel podstromu, který je vystaven ovládacím prvek zdroje dat, je 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, počáteční uzel podstromu je 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 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 určený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í.

Platí pro

Viz také