SiteMapDataSource.StartingNodeOffset Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veri kaynağı denetimi tarafından kullanıma sunulan kök hiyerarşiyi belirleyen başlangıç düğümünden pozitif veya negatif bir tamsayı uzaklığını alır veya ayarlar.

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

Özellik Değeri

Int32

Varsayılan değer 0'dır ve bu da tarafından SiteMapDataSource kullanıma sunulan kök hiyerarşinin başlangıç düğümüyle aynı olduğunu gösterir.

Örnekler

Aşağıdaki kod örneği ve StartingNodeOffset özelliklerinin etkisini StartingNodeUrl gösterir. Örnek birkaç ASP.NET sayfasından, ana sayfadan, ana sayfa bölümünden ve bir Web.sitemap dosyasından oluşur. Web.site haritası dosyası, sitenin hiyerarşik yapısını tanımlar. Bu kod örneği için, 1.aspx, 2.aspx, A.aspx ve B.aspx gibi benzersiz URL'lerle tanımlanan sayfa sayısını aşağıdaki gibi tanımlar:

Site.master sayfası, denetimin SiteMapDataSource içinde ContentPlaceHolder ve TreeView denetimlerini içerir. Özelliğini kullanarak, kullanıma sunulan hiyerarşinin başlangıç düğümünü StartingNodeUrl Default.aspx olarak tanımlar. Site.master dosyası yalnızca Default.aspx sayfası tarafından kullanılır.

1.aspx, 2.aspx, A.aspx gibi diğer tüm sayfalar Section.master ana sayfasını kullanır. Bu ana sayfa Site.master'a çok benzer, ancak deneyebileceğiniz çeşitli SiteMapDataSource denetimler içerir. TreeView Site haritası verilerini görüntüleyen denetim başlangıçta 1'ini StartingNodeOffset belirten öğesine bağlıdırSiteMapDataSource1. Bu, şu anda istenen sayfanın üst düğümünün görüntülendiğini gösterir. Sayfa 1.aspx görüntülerseniz, tarafından TreeView görüntülenen hiyerarşi A, 1, 2'dir. Ancak sayfa 4.aspx görüntülediğinizde hiyerarşi B, 3, 4 olur.

için TreeViewSiteMapDataSource2TreeView öğesini DataSourceID olarak değiştirirseniz, denetim site haritası verilerini farklı görüntüler. kullandığınızdaSiteMapDataSource2StartFromCurrentNode, özelliği olarak ayarlanırtrue, bu da site haritası verilerinin şu anda istenen sayfaya göre görüntülendiği ve özelliğin StartingNodeOffset -1 olarak ayarlandığı ve mümkün olduğunda bir alt düğüm düzeyinin görüntülendiğini gösterir. A.aspx sayfasını görüntülediğinizde, görüntülenen hiyerarşi B ve C gibi tüm eşdüzeyler de dahil olmak üzere geçerli düzeyin hiyerarşisi olur. 1.aspx görüntülediğinizde üst düğümler artık görüntülenmez.

Aşağıdaki kod örneği, bu kod örneğinin diğer bileşenleriyle birlikte kullanabileceğiniz ASP.NET sayfalarından birini gösterir.

<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>  

<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>  
  <h2>1.aspx</h2>  
</asp:Content>

Açıklamalar

StartingNodeOffset Özellik 0 dışında bir değere ayarlanırsa, başlangıç düğümünü ve onunla birlikte denetim tarafından kullanıma sunulan site haritası veri hiyerarşisini SiteMapDataSource etkiler. öğesinin StartingNodeOffset negatif veya pozitif tamsayı değeri, veri kaynağı denetimi tarafından kullanıma sunulan alt ağacının başlangıç düğümünü dengelemek için ve StartingNodeUrl özellikleri tarafından StartFromCurrentNode tanımlanan başlangıç düğümünden site haritası hiyerarşisinde yukarı veya aşağı düzey sayısını tanımlar.

Tanımlanan başlangıç düğümü şu anda istenen sayfayı temsil eden düğümse, StartingNodeOffset yok sayılır.

StartingNodeOffset özelliği negatif bir sayı -n olarak ayarlanırsa, veri kaynağı denetimi tarafından kullanıma sunulan alt ağacının başlangıç düğümü, tanımlanan başlangıç düğümünün üzerindeki üst düğüm n hiyerarşik düzeyleridir. n değeri hiyerarşik ağaçtaki üst düzey sayısından büyükse, alt ağacının başlangıç düğümü site haritası hiyerarşisinin kök düğümüdür.

StartingNodeOffset Özellik pozitif bir +n sayısına ayarlanırsa, kullanıma sunulan alt ağacının başlangıç düğümü, tanımlanan başlangıç düğümünün altındaki alt düğüm n düzeyleridir. Hiyerarşide birden fazla alt düğüm dalı bulunabileceğinden, SiteMapDataSource bir alt düğümü, tanımlanan başlangıç düğümü ile şu anda istenen sayfayı temsil eden düğüm (mümkünse) arasındaki yolda doğrudan çözümlemeye çalışır. şu anda istenen sayfayı temsil eden düğüm, tanımlanan başlangıç düğümünün alt ağacı içinde değilse, özelliğin StartingNodeOffset değeri yoksayılır. şu anda istenen sayfayı temsil eden düğüm tanımlanan başlangıç düğümünü n düzeyden küçükse, şu anda istenen sayfa düğümü başlangıç düğümü olarak kullanılır.

özelliğinin StartingNodeOffset değeri görünüm durumunda depolanır.

Şunlara uygulanır

Aracılığıyla paylaş