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.
Dient zum Abrufen oder Festlegen eines positiven oder negativen ganzzahligen Offsets vom Startknoten, der die Stammhierarchie bestimmt, die vom Datenquellensteuerelement verfügbar gemacht wird.
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, der angibt, dass die von der SiteMapDataSource Stammhierarchie verfügbar gemachte Hierarchie mit dem Startknoten identisch ist.
Beispiele
Im folgenden Codebeispiel wird der Effekt der Eigenschaften und StartingNodeOffset der StartingNodeUrl Eigenschaften veranschaulicht. 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 durch eindeutige URLs identifiziert werden, z. B. 1.aspx, 2.aspx, A.aspx und B.aspx, wie folgt:
Die Site.master-Seite enthält die SiteMapDataSource Steuerelemente TreeView in einem ContentPlaceHolder Steuerelement. Mithilfe der Eigenschaft wird der Startknoten der verfügbar gemachten Hierarchie als Default.aspx StartingNodeUrl identifiziert. Die Site.master-Datei wird nur von der Default.aspx Seite verwendet.
Alle anderen Seiten wie 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 Standortkartendaten anzeigt, ist zunächst an gebunden SiteMapDataSource1, was einen StartingNodeOffset Wert von 1 angibt. Dies gibt an, dass der übergeordnete Knoten der aktuell angeforderten Seite angezeigt wird. Wenn Sie die Seite 1.aspx anzeigen, wird die Hierarchie angezeigt, die TreeView von A, 1, 2 angezeigt wird. Wenn Sie die Seite 4.aspx anzeigen, lautet die Hierarchie jedoch B, 3, 4.
Wenn Sie den DataSourceIDTreeViewSiteMapDataSource2Ausschnitt ändern, zeigt das TreeView Steuerelement Websitekartendaten anders an. Bei Verwendung SiteMapDataSource2wird die StartFromCurrentNode Eigenschaft auf true"-1" festgelegt. Dies bedeutet, dass die Websitekartendaten relativ zur aktuell angeforderten Seite angezeigt werden und die StartingNodeOffset Eigenschaft auf -1 festgelegt ist, sodass nach Möglichkeit eine Ebene untergeordneter Knoten angezeigt wird. Wenn Sie die A.aspx Seite anzeigen, ist die angezeigte Hierarchie die Hierarchie der aktuellen Ebene, einschließlich aller gleichgeordneten Ebenen, 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 sie sich auf den Startknoten und damit auf die Vom Steuerelement verfügbar gemachte Websitezuordnungsdatenhierarchie aus SiteMapDataSource . Der negative oder positive ganzzahlige Wert der StartingNodeOffset Zeichenfolge identifiziert die Anzahl der Ebenen nach oben oder unten der Websitezuordnungshierarchie vom Startknoten, der durch die und StartingNodeUrl die StartFromCurrentNode Eigenschaften identifiziert wird, um den Anfangsknoten der Unterstruktur zu verrechnen, die von der Datenquellensteuerung verfügbar gemacht wird.
Wenn der identifizierte Startknoten der Knoten ist, der die aktuell angeforderte Seite darstellt, wird dies StartingNodeOffset ignoriert.
Wenn die Eigenschaft auf eine negative Zahl -n festgelegt ist, ist der StartingNodeOffset Startknoten der Unterstruktur, die vom Datenquellensteuerelement verfügbar gemacht wird, der übergeordnete Knoten n hierarchische Ebenen oberhalb des identifizierten Startknotens. Wenn der Wert "n " größer als die Anzahl der übergeordneten Ebenen 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 unter dem identifizierten Startknoten. Da in der Hierarchie möglicherweise mehrere Untergeordnete Knoten vorhanden sind, versuchen die SiteMapDataSource Versuche, einen untergeordneten Knoten direkt auf dem Pfad zwischen dem identifizierten Startknoten und dem Knoten aufzulösen, der die aktuell angeforderte Seite darstellt, falls möglich. 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 unterhalb des identifizierten Startknotens ist, wird der aktuell angeforderte Seitenknoten als Startknoten verwendet.
Der Wert der StartingNodeOffset Eigenschaft wird im Ansichtszustand gespeichert.
