SiteMapDataSource.StartingNodeOffset SiteMapDataSource.StartingNodeOffset SiteMapDataSource.StartingNodeOffset SiteMapDataSource.StartingNodeOffset Property

Definizione

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.Gets or sets a positive or negative integer offset from the starting node that determines the root hierarchy that is exposed by the data source control.

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à

Il valore predefinito è 0, a indicare che la gerarchia radice esposta dal controllo SiteMapDataSource corrisponde al nodo di inizio.The default is 0, which indicates that the root hierarchy exposed by the SiteMapDataSource is the same as the starting node.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato StartingNodeUrl l' StartingNodeOffset effetto delle proprietà e.The following code example demonstrates the effect of the StartingNodeUrl and StartingNodeOffset properties. L'esempio è costituito da diverse pagine di ASP.NET, una pagina master, una sezione della pagina master e un file Web. sitemap.The example consists of several ASP.NET pages, a master page, master page section, and a Web.sitemap file. Il file Web. Sitemap definisce la struttura gerarchica del sito.The Web.sitemap file defines the hierarchical structure of the site. Per questo esempio di codice, definisce un numero di pagine identificato da URL univoci, ad esempio 1. aspx, 2. aspx, A. aspx e B. aspx, come indicato di seguito:For this code example, it defines a number of pages identified by unique URLs, such as 1.aspx, 2.aspx, A.aspx, and B.aspx, as follows:

La pagina Site. master contiene i SiteMapDataSource TreeView controlli e all'interno di ContentPlaceHolder un controllo.The Site.master page contains the SiteMapDataSource and a TreeView controls inside a ContentPlaceHolder control. Identifica il nodo iniziale della gerarchia esposta come default. aspx, usando la StartingNodeUrl proprietà.It identifies the starting node of the exposed hierarchy as Default.aspx, using the StartingNodeUrl property. Il file site. master viene utilizzato solo dalla pagina default. aspx.The Site.master file is used by the Default.aspx page only.

Tutte le altre pagine, ad esempio 1. aspx, 2. aspx, A. aspx e così via, usano la pagina master della sezione. master.All other pages, such as 1.aspx, 2.aspx, A.aspx, and so on, use the Section.master master page. Questa pagina master è molto simile a site. master, ma contiene diversi SiteMapDataSource controlli che è possibile sperimentare.This master page is very similar to Site.master, however it contains several SiteMapDataSource controls that you can experiment with. Il TreeView controllo che Visualizza i dati della mappa del sito viene SiteMapDataSource1inizialmente associato a, StartingNodeOffset che specifica un valore pari a 1.The TreeView control that displays site map data is initially bound to SiteMapDataSource1, which specifies a StartingNodeOffset of 1. Indica che viene visualizzato il nodo padre della pagina attualmente richiesta.This indicates that the parent node of the currently requested page is displayed. Se si visualizza la pagina 1. aspx, la gerarchia visualizzata da TreeView è A, 1, 2.If you view page 1.aspx, the hierarchy displayed by the TreeView is A, 1, 2. Tuttavia, se si visualizza la pagina 4. aspx, la gerarchia è B, 3, 4.However, if you view page 4.aspx, the hierarchy is B, 3, 4.

Se si modifica la DataSourceID TreeView per in, SiteMapDataSource2il TreeView controllo Visualizza i dati della mappa del sito in modo diverso.If you change the DataSourceID for the TreeView to SiteMapDataSource2, the TreeView control displays site map data differently. Quando si usa SiteMapDataSource2, la StartFromCurrentNode proprietà è impostata su true, il che significa che i dati della mappa del sito vengono visualizzati in relazione alla pagina richiesta StartingNodeOffset e la proprietà è impostata su-1, a indicare che un livello di nodi figlio è visualizzato, quando possibile.When you use SiteMapDataSource2, the StartFromCurrentNode property is set to true, which means that the site map data is displayed relative to the currently requested page and the StartingNodeOffset property is set to -1, indicating that one level of child nodes is displayed, when possible. 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.When you view the A.aspx page, the hierarchy that is displayed is the hierarchy of the current level, including all siblings, such as B and C. When you view 1.aspx, the parent nodes are no longer displayed.

Nell'esempio di codice riportato di seguito viene illustrata una delle pagine ASP.NET che è possibile utilizzare con gli altri componenti di questo esempio di codice.The following code example demonstrates one of the ASP.NET pages you can use with the other components of this code example.

<%@ 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, influiscono sul nodo iniziale e sulla gerarchia dei dati della mappa del sito esposta SiteMapDataSource dal controllo.If the StartingNodeOffset property is set to a value other than 0, it affects the starting node and with it the site map data hierarchy that is exposed by the SiteMapDataSource control. Il valore integer negativo o positivo di StartingNodeOffset identifica il numero di livelli verso l'alto o verso il basso della gerarchia della mappa del sito del nodo iniziale identificato StartFromCurrentNode dalle proprietà e StartingNodeUrl per l'offset del nodo iniziale del sottoalbero. esposto dal controllo origine dati.The negative or positive integer value of the StartingNodeOffset identifies the number of levels up or down the site map hierarchy from the starting node that is identified by the StartFromCurrentNode and StartingNodeUrl properties to offset the starting node of the subtree that is exposed by data source control.

Se il nodo iniziale identificato è il nodo che rappresenta la pagina attualmente richiesta, StartingNodeOffset viene ignorato.If the identified starting node is the node that represents the currently requested page, the StartingNodeOffset is ignored.

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 al di sopra del nodo iniziale identificato.If the StartingNodeOffset property is set to a negative number -n, the starting node of the subtree that is exposed by the data source control is the ancestor node n hierarchical levels above the identified starting node. 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.If the value n is greater than the number of ancestor levels in the hierarchical tree, the starting node of the subtree is the root node of the site map hierarchy.

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.If the StartingNodeOffset property is set to a positive number +n, the starting node of the subtree that is exposed is a child node n levels below the identified starting node. Poiché potrebbero esistere più rami dei nodi figlio nella gerarchia, SiteMapDataSource tenta di risolvere un nodo figlio direttamente sul percorso tra il nodo iniziale identificato e il nodo che rappresenta la pagina attualmente richiesta, se possibile.Because more than one branch of child nodes might exist in the hierarchy, the SiteMapDataSource attempts to resolve a child node directly on the path between the identified starting node and the node that represents the currently requested page, if possible. 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.If the node that represents the currently requested page is not in the subtree of the identified starting node, the value of the StartingNodeOffset property is ignored. Se il nodo che rappresenta la pagina attualmente richiesta è inferiore a n livelli al di sotto del nodo iniziale identificato, il nodo della pagina attualmente richiesto viene usato come nodo iniziale.If the node that represents the currently requested page is less than n levels below the identified starting node, the currently requested page node is used as the starting node.

Il valore della StartingNodeOffset proprietà viene archiviato nello stato di visualizzazione.The value of the StartingNodeOffset property is stored in view state.

Si applica a

Vedi anche