SiteMapDataSource.StartingNodeOffset Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger en positiv eller negativ heltalsförskjutning från startnoden som avgör rothierarkin som exponeras av datakällans kontroll.
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 IntegerEgenskapsvärde
Standardvärdet är 0, vilket anger att rothierarkin som exponeras av SiteMapDataSource är samma som startnoden.
Exempel
I följande kodexempel visas effekten av StartingNodeUrl egenskaperna och StartingNodeOffset . Exemplet består av flera ASP.NET sidor, en huvudsida, huvudsida och en web.sitemap-fil. Filen Web.sitemap definierar platsens hierarkiska struktur. I det här kodexemplet definieras ett antal sidor som identifieras av unika URL:er, till exempel 1.aspx, 2.aspx, A.aspx och B.aspx enligt följande:
Sidan Site.master innehåller SiteMapDataSource kontrollerna och TreeView inuti en ContentPlaceHolder kontroll. Den identifierar startnoden i den exponerade hierarkin som Default.aspx med hjälp av StartingNodeUrl egenskapen . Filen Site.master används endast av den Default.aspx sidan.
Alla andra sidor, till exempel 1.aspx, 2.aspx, A.aspx och så vidare, använder huvudsidan Section.master. Den här huvudsidan liknar site.master, men den innehåller flera SiteMapDataSource kontroller som du kan experimentera med. Kontrollen TreeView som visar webbplatsöversiktsdata är ursprungligen bunden till SiteMapDataSource1, som anger en StartingNodeOffset av 1. Detta anger att den överordnade noden för den aktuella begärda sidan visas. Om du visar sidan 1.aspx är hierarkin som visas av TreeView A, 1, 2. Men om du visar sidan 4.aspx är hierarkin B, 3, 4.
Om du ändrar DataSourceID för TreeView till SiteMapDataSource2TreeView visar kontrollen webbplatsöversiktsdata på ett annat sätt. När du använder SiteMapDataSource2StartFromCurrentNode är egenskapen inställd på true, vilket innebär att webbplatsöversiktsdata visas i förhållande till den aktuella begärda sidan och StartingNodeOffset egenskapen är inställd på -1, vilket indikerar att en nivå av underordnade noder visas när det är möjligt. När du visar sidan A.aspx är hierarkin som visas hierarkin för den aktuella nivån, inklusive alla syskon, till exempel B och C. När du visar 1.aspx visas inte längre de överordnade noderna.
Följande kodexempel visar en av de ASP.NET sidor som du kan använda med de andra komponenterna i det här kodexemplet.
<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
<h2>1.aspx</h2>
</asp:Content>
Kommentarer
Om egenskapen StartingNodeOffset är inställd på ett annat värde än 0 påverkar den startnoden och med den den platsöversiktsdatahierarki som exponeras av SiteMapDataSource kontrollen. Det negativa eller positiva heltalsvärdet StartingNodeOffset för identifierar antalet nivåer uppåt eller nedåt i platskartehierarkin från startnoden StartFromCurrentNode som identifieras av egenskaperna och StartingNodeUrl för att förskjuta startnoden för underträdet som exponeras av datakällans kontroll.
Om den identifierade startnoden är den nod som representerar den begärda sidan StartingNodeOffset ignoreras den.
StartingNodeOffset Om egenskapen är inställd på ett negativt tal -n är startnoden i underträdet som exponeras av datakällkontrollen den överordnade noden n hierarkiska nivåer ovanför den identifierade startnoden. Om värdet n är större än antalet överordnade nivåer i det hierarkiska trädet är startnoden i underträdet rotnoden i platskartehierarkin.
Om egenskapen StartingNodeOffset är inställd på ett positivt tal +n är startnoden för underträdet som exponeras en underordnad nod n nivåer under den identifierade startnoden. Eftersom det kan finnas fler än en gren av underordnade noder i hierarkin, försöker försöken att matcha en underordnad SiteMapDataSource nod direkt på sökvägen mellan den identifierade startnoden och noden som representerar den aktuella begärda sidan, om möjligt. Om noden som representerar den begärda sidan inte finns i underträdet för den identifierade startnoden ignoreras värdet för StartingNodeOffset egenskapen. Om noden som representerar den begärda sidan är mindre än n nivåer under den identifierade startnoden används den för närvarande begärda sidnoden som startnod.
Värdet för egenskapen StartingNodeOffset lagras i visningstillstånd.
