SiteMapDataSource.StartingNodeOffset Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia dodatnie lub ujemne przesunięcie całkowite z węzła początkowego, który określa hierarchię główną uwidocznianą przez kontrolę źródła danych.

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

Wartość właściwości

Int32

Wartość domyślna to 0, co oznacza, że hierarchia główna uwidoczniona przez SiteMapDataSource program jest taka sama jak węzeł początkowy.

Przykłady

W poniższym przykładzie kodu pokazano efekt StartingNodeUrl właściwości i StartingNodeOffset . Przykład składa się z kilku ASP.NET stron, strony wzorcowej, sekcji strony wzorcowej i pliku web.sitemap. Plik Web.sitemap definiuje hierarchiczną strukturę witryny. W tym przykładzie kodu definiuje on kilka stron zidentyfikowanych przez unikatowe adresy URL, takie jak 1.aspx, 2.aspx, A.aspx i B.aspx, w następujący sposób:

Strona Site.master zawiera kontrolki SiteMapDataSource TreeView i wewnątrz kontrolki ContentPlaceHolder . Identyfikuje węzeł początkowy uwidocznionej hierarchii jako Default.aspx przy użyciu StartingNodeUrl właściwości . Plik Site.master jest używany tylko przez stronę Default.aspx.

Wszystkie inne strony, takie jak 1.aspx, 2.aspx, A.aspx itd., używają strony wzorcowej Section.master. Ta strona wzorcowa jest bardzo podobna do site.master, jednak zawiera kilka SiteMapDataSource kontrolek, z którymi można eksperymentować. Kontrolka TreeView , która wyświetla dane mapy witryny, jest początkowo powiązana z SiteMapDataSource1elementem StartingNodeOffset , który określa wartość 1. Oznacza to, że jest wyświetlany węzeł nadrzędny aktualnie żądanej strony. Jeśli wyświetlisz stronę 1.aspx, hierarchia wyświetlana przez element TreeView to A, 1, 2. Jeśli jednak wyświetlisz stronę 4.aspx, hierarchia to B, 3, 4.

Jeśli zmienisz DataSourceID wartość dla TreeView SiteMapDataSource2elementu na , kontrolka TreeView wyświetli dane mapy witryny w inny sposób. Jeśli używasz SiteMapDataSource2, StartFromCurrentNode właściwość jest ustawiona na true, co oznacza, że dane mapy witryny są wyświetlane względem aktualnie żądanej strony, a StartingNodeOffset właściwość jest ustawiona na -1, co oznacza, że wyświetlany jest jeden poziom węzłów podrzędnych, jeśli jest to możliwe. Po wyświetleniu strony A.aspx wyświetlana hierarchia jest hierarchią bieżącego poziomu, w tym wszystkich elementów równorzędnych, takich jak B i C. Po wyświetleniu wersji 1.aspx węzły nadrzędne nie są już wyświetlane.

Poniższy przykład kodu przedstawia jedną z ASP.NET stron, których można użyć z innymi składnikami tego przykładu kodu.

<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>  

<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>  
  <h2>1.aspx</h2>  
</asp:Content>

Uwagi

StartingNodeOffset Jeśli właściwość jest ustawiona na wartość inną niż 0, ma wpływ na węzeł początkowy i z nią hierarchię danych mapy lokacji, która jest uwidaczniona przez kontrolkęSiteMapDataSource. Ujemna lub dodatnia wartość StartingNodeOffset całkowita określa liczbę poziomów w górę lub w dół hierarchii mapy lokacji z węzła początkowego, który jest identyfikowany przez StartFromCurrentNode właściwości i StartingNodeUrl w celu przesunięcia węzła początkowego poddrzewa uwidocznionego przez kontrolę źródła danych.

Jeśli zidentyfikowany węzeł początkowy jest węzłem reprezentującym aktualnie żądaną stronę, StartingNodeOffset element jest ignorowany.

StartingNodeOffset Jeśli właściwość jest ustawiona na liczbę ujemną -n, węzeł początkowy poddrzewa uwidocznionego przez kontrolkę źródła danych jest węzłem nadrzędnym n poziomów hierarchicznych powyżej zidentyfikowanego węzła początkowego. Jeśli wartość n jest większa niż liczba poziomów nadrzędnych w drzewie hierarchicznym, węzeł początkowy poddrzewa jest węzłem głównym hierarchii mapy lokacji.

StartingNodeOffset Jeśli właściwość jest ustawiona na liczbę dodatnią +n, węzeł początkowy uwidocznionego poddrzewa jest podrzędnym węzłem n poziomów poniżej zidentyfikowanego węzła początkowego. Ponieważ w hierarchii może istnieć więcej niż jedna gałąź węzłów podrzędnych, SiteMapDataSource próby rozpoznania węzła podrzędnego bezpośrednio na ścieżce między zidentyfikowanym węzłem początkowym a węzłem reprezentującym aktualnie żądaną stronę, jeśli to możliwe. Jeśli węzeł reprezentujący aktualnie żądaną stronę nie znajduje się w poddrzewie zidentyfikowanego węzła początkowego, wartość StartingNodeOffset właściwości jest ignorowana. Jeśli węzeł reprezentujący aktualnie żądaną stronę jest mniejszy niż n poziomów poniżej zidentyfikowanego węzła początkowego, obecnie żądany węzeł strony jest używany jako węzeł początkowy.

Wartość StartingNodeOffset właściwości jest przechowywana w stanie widoku.

Dotyczy