SiteMapDataSource.StartingNodeOffset Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Overridable Property StartingNodeOffset As IntegerEigenschaftswert
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 der Effekt der StartingNodeUrl Eigenschaften veranschaulicht StartingNodeOffset . Das Beispiel besteht aus mehreren ASP.NET Seiten, einer Gestaltungsvorlage, einem Gestaltungsvorlagenabschnitt und einer Web.sitemap-Datei. Die Web.sitemap-Datei definiert die hierarchische Struktur der Website. In diesem Codebeispiel wird eine Anzahl von Seiten definiert, die von eindeutigen URLs identifiziert werden, z. B. 1.aspx, 2.aspx, A.aspx und B.aspx, wie folgt:
Die Website.Gestaltungsvorlage enthält die SiteMapDataSource und ein TreeView Steuerelement innerhalb eines ContentPlaceHolder Steuerelements. Es identifiziert den Startknoten der verfügbaren Hierarchie als Default.aspx mithilfe der StartingNodeUrl Eigenschaft. Die Website.master-Datei wird nur auf der Seite "Default.aspx" verwendet.
Alle anderen Seiten, z. B. 1.aspx, 2.aspx, A.aspx usw., verwenden Sie die Gestaltungsvorlage "Section.master". Diese Gestaltungsvorlage ist sehr ähnlich wie Site.master, enthält jedoch mehrere SiteMapDataSource Steuerelemente, mit denen Sie experimentieren können. Das TreeView Steuerelement, das Websitezuordnungsdaten anzeigt, ist zunächst gebunden SiteMapDataSource1, was eine StartingNodeOffset von 1 angibt. Dies gibt an, dass der übergeordnete Knoten der aktuell angeforderten Seite angezeigt wird. Wenn Sie seite 1.aspx anzeigen, wird die Hierarchie angezeigt, die von A TreeView , 1, 2 angezeigt wird. Wenn Sie jedoch die Seite 4.aspx anzeigen, lautet die Hierarchie B, 3, 4.
Wenn Sie das DataSourceID Für das TreeView Zu SiteMapDataSource2ändern, zeigt das TreeView Steuerelement Websitezuordnungsdaten anders an. Wenn Sie verwendenSiteMapDataSource2, wird die Eigenschaft auf true" festgelegt" festgelegt, was bedeutet, dass die StartFromCurrentNode Websitezuordnungsdaten relativ zur aktuell angeforderten Seite angezeigt werden und die StartingNodeOffset Eigenschaft auf -1 festgelegt ist, und gibt an, dass eine Ebene untergeordneter Knoten angezeigt wird, wenn möglich. Wenn Sie die A.aspx-Seite anzeigen, ist die Hierarchie, die angezeigt wird, die Hierarchie der aktuellen Ebene, einschließlich aller Geschwister, z. 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 es sich auf den Startknoten und mit der Websitezuordnungsdatenhierarchie aus, die vom SiteMapDataSource Steuerelement verfügbar gemacht wird. Der negative oder positive ganzzahlige Wert der StartingNodeOffset Zeichenfolge identifiziert die Anzahl der Ebenen nach oben oder unten aus dem Startknoten, der durch StartFromCurrentNode die und StartingNodeUrl die Eigenschaften identifiziert wird, um den Startknoten der von der Datenquellensteuerung verfügbar gemachten Unterstruktur zu versatzen.
Wenn der identifizierte Startknoten der Knoten ist, der die aktuell angeforderte Seite darstellt, wird dies StartingNodeOffset ignoriert.
Wenn die StartingNodeOffset Eigenschaft auf eine negative Zahl -n festgelegt ist, ist der Startknoten der vom Datenquellensteuerelement verfügbar gemachten Unterstruktur der vorgängerknoten n hierarchische Ebenen oberhalb des identifizierten Startknotens. 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 Websitezuordnungshierarchie.
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 mehrere untergeordnete Knoten vorhanden sind, versucht die SiteMapDataSource Lösung eines untergeordneten Knotens direkt auf dem Pfad zwischen dem identifizierten Startknoten und dem Knoten, der die aktuell angeforderte Seite darstellt, sofern möglich. Wenn der Knoten, der die aktuell angeforderte Seite darstellt, nicht in der Unterstruktur des identifizierten Startknotens liegt, wird der Wert der StartingNodeOffset Eigenschaft ignoriert. Wenn der Knoten, der die aktuell angeforderte Seite darstellt, kleiner als n Ebenen unterhalb des identifizierten Startknotens ist, wird der aktuell angeforderte Seitenknoten als Startknoten verwendet.
Der Wert der StartingNodeOffset Eigenschaft wird im Ansichtszustand gespeichert.