SiteMapDataSource.StartingNodeOffset Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur offset bilangan bulat positif atau negatif dari simpul awal yang menentukan hierarki akar yang diekspos oleh kontrol sumber data.

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

Nilai Properti

Int32

Defaultnya adalah 0, yang menunjukkan bahwa hierarki akar yang diekspos oleh sama dengan SiteMapDataSource simpul awal.

Contoh

Contoh kode berikut menunjukkan efek properti StartingNodeUrl dan StartingNodeOffset . Contohnya terdiri dari beberapa halaman ASP.NET, halaman master, bagian halaman master, dan file Web.sitemap. File Web.sitemap menentukan struktur hierarki situs. Untuk contoh kode ini, ini mendefinisikan sejumlah halaman yang diidentifikasi oleh URL unik, seperti 1.aspx, 2.aspx, A.aspx, dan B.aspx, sebagai berikut:

Halaman Site.master berisi SiteMapDataSource dan TreeView kontrol di dalam ContentPlaceHolder kontrol. Ini mengidentifikasi simpul awal hierarki yang diekspos sebagai Default.aspx, menggunakan StartingNodeUrl properti . File Site.master hanya digunakan oleh halaman Default.aspx.

Semua halaman lain, seperti 1.aspx, 2.aspx, A.aspx, dan sebagainya, gunakan halaman master Section.master. Halaman master ini sangat mirip dengan Site.master, namun berisi beberapa SiteMapDataSource kontrol yang dapat Anda eksperimen. TreeView Kontrol yang menampilkan data peta situs awalnya terikat ke SiteMapDataSource1, yang menentukan StartingNodeOffset 1. Ini menunjukkan bahwa simpul induk dari halaman yang saat ini diminta ditampilkan. Jika Anda melihat halaman 1.aspx, hierarki yang ditampilkan adalah TreeView A, 1, 2. Namun, jika Anda melihat halaman 4.aspx, hierarkinya adalah B, 3, 4.

Jika Anda mengubah DataSourceID untuk TreeView ke SiteMapDataSource2, TreeView kontrol menampilkan data peta situs secara berbeda. Saat Anda menggunakan SiteMapDataSource2, StartFromCurrentNode properti diatur ke true, yang berarti bahwa data peta situs ditampilkan relatif terhadap halaman yang saat ini diminta dan StartingNodeOffset properti diatur ke -1, menunjukkan bahwa satu tingkat simpul anak ditampilkan, jika memungkinkan. Saat Anda melihat halaman A.aspx, hierarki yang ditampilkan adalah hierarki tingkat saat ini, termasuk semua saudara kandung, seperti B dan C. Saat Anda melihat 1.aspx, simpul induk tidak lagi ditampilkan.

Contoh kode berikut menunjukkan salah satu halaman ASP.NET yang dapat Anda gunakan dengan komponen lain dari contoh kode ini.

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

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

Keterangan

StartingNodeOffset Jika properti diatur ke nilai selain 0, properti akan memengaruhi simpul awal dan dengannya hierarki data peta situs yang diekspos oleh SiteMapDataSource kontrol. Nilai bilangan StartingNodeOffset bulat negatif atau positif mengidentifikasi jumlah tingkat ke atas atau ke bawah hierarki peta situs dari simpul awal yang diidentifikasi oleh StartFromCurrentNode properti dan StartingNodeUrl untuk mengimbangi simpul awal subtree yang diekspos oleh kontrol sumber data.

Jika simpul awal yang diidentifikasi adalah simpul yang mewakili halaman yang saat ini diminta, StartingNodeOffset diabaikan.

StartingNodeOffset Jika properti diatur ke angka negatif -n, simpul awal subtree yang diekspos oleh kontrol sumber data adalah node leluhur n tingkat hierarkis di atas simpul awal yang diidentifikasi. Jika nilai n lebih besar dari jumlah tingkat leluhur di pohon hierarkis, simpul awal subtree adalah simpul akar hierarki peta situs.

StartingNodeOffset Jika properti diatur ke angka positif +n, simpul awal subtree yang terekspos adalah tingkat n simpul anak di bawah simpul awal yang diidentifikasi. Karena lebih dari satu cabang simpul anak mungkin ada dalam hierarki, SiteMapDataSource upaya untuk menyelesaikan simpul anak langsung di jalur antara simpul awal yang diidentifikasi dan simpul yang mewakili halaman yang saat ini diminta, jika memungkinkan. Jika simpul yang mewakili halaman yang saat ini diminta tidak berada dalam subtree dari simpul awal yang diidentifikasi, nilai StartingNodeOffset properti diabaikan. Jika simpul yang mewakili halaman yang saat ini diminta kurang dari n tingkat di bawah simpul awal yang diidentifikasi, simpul halaman yang saat ini diminta digunakan sebagai simpul awal.

Nilai StartingNodeOffset properti disimpan dalam status tampilan.

Berlaku untuk

Bagikan melalui