Udostępnij za pośrednictwem


SiteMapDataSource.StartingNodeOffset Właściwość

Definicja

Pobiera lub ustawia dodatnie lub ujemne przesunięcie całkowite z węzła początkowego, który określa hierarchię główną uwidocznioną 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

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

Przykłady

Poniższy przykład kodu przedstawia efekt StartingNodeUrl właściwości i StartingNodeOffset . Przykład składa się z kilku stron ASP.NET, strony wzorcowej, sekcji strony wzorcowej i pliku mapy web.site. Plik Web.sitemap definiuje hierarchiczną strukturę witryny. W tym przykładzie kodu definiuje liczbę 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 SiteMapDataSourceTreeView 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 pliku 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 , który określa wartość StartingNodeOffset 1. Oznacza to, że zostanie wyświetlony 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 dla DataSourceID elementu na TreeViewSiteMapDataSource2, kontrolka TreeView wyświetla dane mapy witryny inaczej. W przypadku użycia SiteMapDataSource2StartFromCurrentNode właściwość jest ustawiona na truewartość , co oznacza, że dane mapy witryny są wyświetlane względem aktualnie żądanej strony, a StartingNodeOffset właściwość jest ustawiona na wartość -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 1.aspx węzły nadrzędne nie będą już wyświetlane.

Poniższy przykład kodu przedstawia jedną z stron ASP.NET, 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, wpływa na węzeł początkowy i z nią hierarchię danych mapy lokacji, która jest uwidoczniona przez kontrolkęSiteMapDataSource. Ujemna lub dodatnia wartość StartingNodeOffset całkowita elementu identyfikuje 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, który reprezentuje aktualnie żądaną stronę, StartingNodeOffset jest ignorowany.

StartingNodeOffset Jeśli właściwość jest ustawiona na liczbę ujemną -n, węzeł początkowy poddrzewa, który jest uwidoczniony przez kontrolkę źródła danych, to węzeł węzła węzła nadrzędnego n poziomów hierarchicznych powyżej zidentyfikowanego węzła początkowego. Jeśli wartość n jest większa niż liczba poziomów przodków 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 węzłem podrzędnym 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 rozwiązania 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, aktualnie żądany węzeł strony jest używany jako węzeł początkowy.

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

Dotyczy

Zobacz też