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 intero positivo o negativo dal nodo iniziale che determina la gerarchia radice 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, che indica che la gerarchia radice esposta da SiteMapDataSource è uguale al nodo iniziale.
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 di TreeView 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 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 DataSourceIDTreeViewSiteMapDataSource2, il TreeView controllo visualizza i dati della mappa del sito in modo diverso. Quando si utilizza 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, 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 SiteMapDataSource mappa del 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, l'oggetto StartingNodeOffset viene 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 predecessore 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 al di sotto del nodo iniziale identificato. Poiché nella gerarchia potrebbero esistere più rami di nodi figlio, il SiteMapDataSource tentativo 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.
