SiteMapDataSource.StartingNodeOffset Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un offset di Integer positivo o negativo dal nodo di inizio che determina la gerarchia radice che viene esposta dal controllo origine dati.
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 IntegerValore della proprietà
Il valore predefinito è 0, a indicare che la gerarchia radice esposta dal controllo SiteMapDataSource corrisponde al nodo di inizio.
Esempio
Nell'esempio di codice seguente viene illustrato l'effetto delle StartingNodeUrl proprietà e StartingNodeOffset . L'esempio è costituito da diverse pagine ASP.NET, una pagina master, una sezione della pagina master e un file Web.sitemap. Il file Web.sitemap definisce la struttura gerarchica del sito. Per questo esempio di codice, definisce una serie di pagine identificate da URL univoci, ad esempio 1.aspx, 2.aspx, A.aspx e B.aspx, come indicato di seguito:
La pagina Site.master contiene i SiteMapDataSource controlli e all'interno TreeView di un ContentPlaceHolder controllo . Identifica il nodo iniziale della gerarchia esposta come Default.aspx, usando la StartingNodeUrl proprietà . Il file Site.master viene utilizzato solo dalla pagina Default.aspx.
Tutte le altre pagine, ad esempio 1.aspx, 2.aspx, A.aspx e così via, usano la pagina master Section.master. Questa pagina master è molto simile a Site.master, ma contiene diversi SiteMapDataSource controlli che è possibile sperimentare. Il TreeView controllo che visualizza i dati della mappa del sito è inizialmente associato a , che specifica un valore StartingNodeOffset pari a SiteMapDataSource11. Ciò indica che viene visualizzato il nodo padre della pagina attualmente richiesta. Se si visualizza la pagina 1.aspx, la gerarchia visualizzata da TreeView è A, 1, 2. Tuttavia, se si visualizza la pagina 4.aspx, la gerarchia è B, 3, 4.
Se si modifica l'oggetto per in DataSourceIDTreeViewSiteMapDataSource2, il controllo visualizza i dati della mappa del TreeView sito in modo diverso. Quando si usa SiteMapDataSource2, la StartFromCurrentNode proprietà è impostata su , il che significa che i dati della mappa del sito vengono visualizzati rispetto alla pagina attualmente richiesta e la StartingNodeOffset proprietà è impostata truesu -1, a indicare che viene visualizzato un livello di nodi figlio, quando possibile. Quando si visualizza la pagina A.aspx, la gerarchia visualizzata è la gerarchia del livello corrente, inclusi tutti gli elementi di pari livello, ad esempio B e C. Quando si visualizza 1.aspx, i nodi padre non vengono più visualizzati.
Nell'esempio di codice seguente viene illustrata una delle pagine ASP.NET che è possibile usare con gli altri componenti di questo esempio di codice.
<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
<h2>1.aspx</h2>
</asp:Content>
Commenti
Se la StartingNodeOffset proprietà è impostata su un valore diverso da 0, influisce sul nodo iniziale e sulla gerarchia dei dati della mappa del SiteMapDataSource sito esposta dal controllo . Il valore intero negativo o positivo di StartingNodeOffset identifica il numero di livelli verso l'alto o verso il basso della gerarchia della mappa del sito dal nodo iniziale identificato dalle StartFromCurrentNode proprietà e StartingNodeUrl per compensare il nodo iniziale del sottoalbero esposto dal controllo origine dati.
Se il nodo iniziale identificato è il nodo che rappresenta la pagina attualmente richiesta, viene StartingNodeOffset ignorato.
Se la StartingNodeOffset proprietà è impostata su un numero negativo -n, il nodo iniziale del sottoalbero esposto dal controllo origine dati è il nodo predecessore n livelli gerarchici sopra il nodo iniziale identificato. Se il valore n è maggiore del numero di livelli predecessori nell'albero gerarchico, il nodo iniziale del sottoalbero è il nodo radice della gerarchia della mappa del sito.
Se la StartingNodeOffset proprietà è impostata su un numero positivo +n, il nodo iniziale del sottoalbero esposto è un nodo figlio n livelli sotto il nodo iniziale identificato. Poiché nella gerarchia potrebbero esistere più rami di nodi figlio, i SiteMapDataSource tentativi di risolvere un nodo figlio direttamente nel percorso tra il nodo iniziale identificato e il nodo che rappresenta la pagina attualmente richiesta, se possibile. Se il nodo che rappresenta la pagina attualmente richiesta non si trova nel sottoalbero del nodo iniziale identificato, il valore della StartingNodeOffset proprietà viene ignorato. Se il nodo che rappresenta la pagina attualmente richiesta è inferiore a n livelli al di sotto del nodo iniziale identificato, il nodo di pagina attualmente richiesto viene usato come nodo iniziale.
Il valore della StartingNodeOffset proprietà viene archiviato nello stato di visualizzazione.
