SiteMapDataSource.StartingNodeOffset Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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, set
Public Overridable Property StartingNodeOffset As Integer

Valore della proprietà

Int32

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 un numero 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 controlli e TreeView all'interno SiteMapDataSource di un ContentPlaceHolder controllo. Identifica il nodo iniziale della gerarchia esposta come Default.aspx usando la StartingNodeUrl proprietà . Il file Site.master viene usato 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 StartingNodeOffset valore 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 DataSourceID , il TreeView controllo visualizza i dati della TreeViewSiteMapDataSource2mappa del sito in modo diverso. Quando si usa SiteMapDataSource2, la StartFromCurrentNode proprietà è impostata su true, il che significa che i dati della mappa del sito vengono visualizzati rispetto alla pagina attualmente richiesta e la StartingNodeOffset proprietà è impostata su -1, indicando 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 i fratelli, ad esempio B e C. Quando si visualizza 1.aspx, i nodi padre non vengono più visualizzati.

L'esempio di codice seguente illustra 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 dell'oggetto StartingNodeOffset identifica il numero di livelli verso l'alto o 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é più di un ramo di nodi figlio potrebbe esistere nella gerarchia, i SiteMapDataSource tentativi di risolvere un nodo figlio direttamente sul 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 proprietà viene archiviato nello stato di StartingNodeOffset visualizzazione.

Si applica a

Vedi anche