SiteMapDataSource.StartingNodeOffset Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft einen positiven oder negativen Ganzzahlwert ab, der vom Startknoten abzweigt, der die vom Datenquellen-Steuerelement verfügbar gemachte Stammhierarchie festlegt, oder legt diesen Wert fest.

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

Eigenschaftswert

Int32

Der Standardwert ist 0 (null) und besagt, dass die von der SiteMapDataSource verfügbar gemachte Stammhierarchie mit dem Startknoten übereinstimmt.

Beispiele

Im folgenden Codebeispiel wird die Wirkung der StartingNodeUrl Eigenschaften und StartingNodeOffset veranschaulicht. Das Beispiel besteht aus mehreren ASP.NET Seiten, einer Gestaltungsvorlage, einem Gestaltungsvorlagenabschnitt und einer Web.sitemap-Datei. Die Datei Web.sitemap definiert die hierarchische Struktur der Website. In diesem Codebeispiel definiert es eine Anzahl von Seiten, die durch eindeutige URLs identifiziert werden, z. B. 1.aspx, 2.aspx, A.aspx und B.aspx, wie folgt:

Die Seite Site.master enthält das SiteMapDataSource - und ein TreeView -Steuerelement in einem ContentPlaceHolder Steuerelement. Der Startknoten der verfügbar gemachten Hierarchie wird mithilfe StartingNodeUrl der -Eigenschaft als Default.aspx identifiziert. Die Datei Site.master wird nur von der Default.aspx Seite verwendet.

Alle anderen Seiten, z. B. 1.aspx, 2.aspx, A.aspx usw., verwenden die Gestaltungsvorlage Section.master. Diese Gestaltungsvorlage ist Site.master sehr ähnlich, enthält jedoch mehrere SiteMapDataSource Steuerelemente, mit denen Sie experimentieren können. Das TreeView Steuerelement, das Siteübersichtsdaten anzeigt, ist zunächst an SiteMapDataSource1gebunden, was einen StartingNodeOffset von 1 angibt. Dies gibt an, dass der übergeordnete Knoten der aktuell angeforderten Seite angezeigt wird. Wenn Sie die Seite 1.aspx anzeigen, ist die von TreeView angezeigte Hierarchie A, 1, 2. Wenn Sie jedoch die Seite 4.aspx anzeigen, lautet die Hierarchie B, 3, 4.

Wenn Sie die DataSourceID für TreeView in SiteMapDataSource2ändern, zeigt das TreeView Steuerelement Standortübersichtsdaten unterschiedlich an. Wenn Sie verwenden SiteMapDataSource2, wird die StartFromCurrentNode -Eigenschaft auf truefestgelegt, was bedeutet, dass die Siteübersichtsdaten relativ zur aktuell angeforderten Seite angezeigt und die StartingNodeOffset Eigenschaft auf -1 festgelegt ist, was angibt, dass nach Möglichkeit eine Ebene von untergeordneten Knoten angezeigt wird. Wenn Sie die Seite A.aspx anzeigen, wird die Hierarchie der aktuellen Ebene angezeigt, einschließlich aller gleichgeordneten Elemente, z. B. B und C. Wenn Sie 1.aspx anzeigen, werden die übergeordneten Knoten nicht mehr angezeigt.

Im folgenden Codebeispiel wird eine der ASP.NET Seiten veranschaulicht, die Sie mit den anderen Komponenten dieses Codebeispiels verwenden können.

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

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

Hinweise

Wenn die StartingNodeOffset Eigenschaft auf einen anderen Wert als 0 festgelegt ist, wirkt sich dies auf den Startknoten und damit auf die Vom -Steuerelement verfügbar gemachte SiteMapDataSource Siteübersichtsdatenhierarchie aus. Der negative oder positive ganzzahlige Wert des StartingNodeOffset identifiziert die Anzahl der Ebenen nach oben oder unten in der Siteübersichtshierarchie vom Startknoten, der durch die StartFromCurrentNode Eigenschaften und StartingNodeUrl identifiziert wird, um den Startknoten der Teilstruktur zu offsetn, die vom Datenquellensteuerelement verfügbar gemacht wird.

Wenn der identifizierte Startknoten der Knoten ist, der die aktuell angeforderte Seite darstellt, wird ignoriert StartingNodeOffset .

Wenn die StartingNodeOffset Eigenschaft auf eine negative Zahl -n festgelegt ist, ist der Startknoten der Unterstruktur, die vom Datenquellensteuerelement verfügbar gemacht wird, der Vorgängerknoten n Hierarchischen Ebenen über dem identifizierten Startknoten. Wenn der Wert n größer als die Anzahl der Vorgängerebenen in der hierarchischen Struktur ist, ist der Startknoten der Unterstruktur der Stammknoten der Siteübersichtshierarchie.

Wenn die StartingNodeOffset Eigenschaft auf eine positive Zahl +n festgelegt ist, ist der Startknoten der verfügbar gemachten Unterstruktur ein untergeordneter Knoten n Ebenen unterhalb des identifizierten Startknotens. Da in der Hierarchie möglicherweise mehr als ein Branch von untergeordneten Knoten vorhanden ist, wird versucht, SiteMapDataSource einen untergeordneten Knoten nach Möglichkeit direkt im Pfad zwischen dem identifizierten Startknoten und dem Knoten aufzulösen, der die aktuell angeforderte Seite darstellt. Wenn sich der Knoten, der die aktuell angeforderte Seite darstellt, nicht in der Unterstruktur des identifizierten Startknotens befindet, wird der Wert der StartingNodeOffset -Eigenschaft ignoriert. Wenn der Knoten, der die aktuell angeforderte Seite darstellt, kleiner als n Ebenen unter dem identifizierten Startknoten ist, wird der aktuell angeforderte Seitenknoten als Startknoten verwendet.

Der Wert der StartingNodeOffset Eigenschaft wird im Ansichtszustand gespeichert.

Weitere Informationen

• StartingNodeUrl
• StartFromCurrentNode
• ASP.NET Websitenavigation
• SiteMapPath-Webserversteuerelement
• Schützen ASP.NET Websitenavigation
• Übersicht über das SiteMapDataSource-Webserversteuerelement