Bagikan melalui


XmlSiteMapProvider Kelas

Definisi

Kelas XmlSiteMapProvider ini berasal dari SiteMapProvider kelas dan merupakan penyedia peta situs default untuk ASP.NET. Kelas XmlSiteMapProvider menghasilkan pohon peta situs dari file XML dengan ekstensi nama file .sitemap.

public ref class XmlSiteMapProvider : System::Web::StaticSiteMapProvider, IDisposable
public class XmlSiteMapProvider : System.Web.StaticSiteMapProvider, IDisposable
type XmlSiteMapProvider = class
    inherit StaticSiteMapProvider
    interface IDisposable
Public Class XmlSiteMapProvider
Inherits StaticSiteMapProvider
Implements IDisposable
Warisan
Penerapan

Keterangan

Kelas XmlSiteMapProvider memuat data peta situs dari file XML yang mengikuti skema yang diketahui. Data peta situs dibatasi oleh <siteMap> tag dan terdiri dari tag berlapis <siteMapNode> . Dua batasan diberlakukan oleh SiteMapProvider kelas dan XmlSiteMapProvider pada struktur data peta situs:

  • Hanya satu simpul akar yang bisa ada.

  • Untuk SiteMapNode objek yang menentukan URL, URL harus unik dalam cakupan penyedia. (Untuk simpul yang tidak menentukan URL, semua kunci harus unik.)

Contoh kode berikut menunjukkan contoh file XML yang dapat digunakan dengan XmlSiteMapProvider.

<siteMap>  
  <siteMapNode title="RootNode" description="This is the root node of the site map. There can be only one root node." url="Page1.aspx" >  
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page2.aspx">  
      <siteMapNode title="ChildOfChildNode" description="SiteMapNode objects can be nested to any level." url="Page3.aspx"/>  
    </siteMapNode>  
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page4.aspx"/>  
  </siteMapNode>  
</siteMap>  

XmlSiteMapProvider adalah penyedia default untuk ASP.NET dan membaca data XML dari file bernama Web.sitemap yang terletak di dalam struktur direktori aplikasi ASP.NET. Secara default, file Web.sitemap terletak di akar aplikasi; namun, jika Anda ingin mengubah nama atau lokasi file tempat XmlSiteMapProvider memuat data, Anda dapat mengambil alih konfigurasi default dalam file Web.config Anda. Dengan mengganti pengaturan konfigurasi default dalam file Web.config, Anda dapat menyesuaikan perilaku XmlSiteMapProvider untuk setiap aplikasi ASP.NET, seperlunya.

Contoh kode berikut menunjukkan contoh file Web.config, di mana XmlSiteMapProvider masih digunakan, tetapi file peta situs yang berbeda digunakan. Karena semua penyedia dalam SiteMapProviderCollection objek harus diberi nama secara unik, penyedia yang ditentukan dalam file Web.config menggunakan nama selain default tetapi juga diatur sebagai penyedia default sehingga akan digunakan alih-alih XmlSiteMapProvider yang ditentukan dalam konfigurasi ASP.NET default.

Catatan

Anda bisa mengubah nama file data navigasi situs, tetapi Anda tidak dapat mengubah ekstensinya. Satu-satunya XmlSiteMapProvider membaca data dari file yang diberi nama dengan ekstensi nama file .sitemap.

<siteMap defaultProvider="MyXmlSiteMapProvider" enabled="true">  
  <providers>  
    <add name="MyXmlSiteMapProvider"  
      description="SiteMap provider that reads in .sitemap files."  
      type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"  
      siteMapFile="CustomWeb.sitemap" />  
  </providers>  
</siteMap>  

Konstruktor

XmlSiteMapProvider()

Membuat instans XmlSiteMapProvider kelas baru yang tidak disebutkan namanya.

Properti

CurrentNode

SiteMapNode Mendapatkan objek yang mewakili halaman yang saat ini diminta.

CurrentNode

SiteMapNode Mendapatkan objek yang mewakili halaman yang saat ini diminta.

(Diperoleh dari SiteMapProvider)
Description

Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya.

(Diperoleh dari ProviderBase)
EnableLocalization

Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah nilai SiteMapNode atribut yang dilokalkan dikembalikan.

(Diperoleh dari SiteMapProvider)
Name

Mendapatkan nama yang mudah diingat yang digunakan untuk merujuk ke penyedia selama konfigurasi.

(Diperoleh dari ProviderBase)
ParentProvider

Mendapatkan atau mengatur objek induk SiteMapProvider penyedia saat ini.

(Diperoleh dari SiteMapProvider)
ResourceKey

Mendapatkan atau mengatur kunci sumber daya yang digunakan untuk melokalisasi SiteMapNode atribut.

(Diperoleh dari SiteMapProvider)
RootNode

Mendapatkan simpul akar peta situs.

RootProvider

Mendapatkan objek akar SiteMapProvider dalam hierarki penyedia saat ini.

(Diperoleh dari SiteMapProvider)
SecurityTrimmingEnabled

Mendapatkan nilai Boolean yang menunjukkan apakah penyedia peta situs memfilter simpul peta situs berdasarkan peran pengguna.

(Diperoleh dari SiteMapProvider)

Metode

AddNode(SiteMapNode, SiteMapNode)

SiteMapNode Menambahkan objek ke koleksi yang dikelola oleh penyedia saat ini.

AddNode(SiteMapNode)

SiteMapNode Menambahkan objek ke kumpulan simpul yang dikelola oleh penyedia peta situs.

(Diperoleh dari SiteMapProvider)
AddProvider(String, SiteMapNode)

Menautkan penyedia peta situs anak ke penyedia saat ini.

BuildSiteMap()

Memuat informasi peta situs dari file XML dan menyusunnya dalam memori.

Clear()

Menghapus semua elemen dalam kumpulan simpul peta situs anak dan induk dan penyedia peta situs yang XmlSiteMapProvider dilacak secara internal objek sebagai bagian dari statusnya.

Dispose()

Memberi tahu pemantau file dari file Web.sitemap bahwa XmlSiteMapProvider objek tidak lagi memerlukan file untuk dipantau.

Dispose(Boolean)

Memberi tahu pemantau file dari file Web.sitemap bahwa XmlSiteMapProvider objek tidak lagi memerlukan file untuk dipantau. Metode ini Dispose(Boolean) mengambil parameter Boolean yang menunjukkan apakah metode dipanggil oleh kode pengguna.

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindSiteMapNode(HttpContext)

SiteMapNode Mengambil objek yang mewakili halaman yang saat ini diminta menggunakan objek yang ditentukanHttpContext.

(Diperoleh dari SiteMapProvider)
FindSiteMapNode(String)

SiteMapNode Mengambil objek yang mewakili halaman pada URL yang ditentukan.

FindSiteMapNodeFromKey(String)

SiteMapNode Mengambil objek berdasarkan kunci tertentu.

GetChildNodes(SiteMapNode)

Mengembalikan simpul anak dari peta situs.

GetChildNodes(SiteMapNode)

Mengambil simpul peta situs anak dari objek tertentu SiteMapNode .

(Diperoleh dari StaticSiteMapProvider)
GetCurrentNodeAndHintAncestorNodes(Int32)

Menyediakan metode pencarian yang dioptimalkan untuk penyedia peta situs saat mengambil simpul untuk halaman yang saat ini diminta dan mengambil simpul peta situs induk dan leluhur untuk halaman saat ini.

(Diperoleh dari SiteMapProvider)
GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)

Menyediakan metode pencarian yang dioptimalkan untuk penyedia peta situs saat mengambil simpul untuk halaman yang saat ini diminta dan mengambil simpul peta situs di dekat simpul saat ini.

(Diperoleh dari SiteMapProvider)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetParentNode(SiteMapNode)

Mengembalikan simpul induk peta situs.

GetParentNode(SiteMapNode)

Mengambil simpul peta situs induk dari objek tertentu SiteMapNode .

(Diperoleh dari StaticSiteMapProvider)
GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)

Menyediakan metode pencarian yang dioptimalkan untuk penyedia peta situs saat mengambil simpul leluhur untuk halaman yang saat ini diminta dan mengambil simpul turunan untuk leluhur.

(Diperoleh dari SiteMapProvider)
GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)

Menyediakan metode pencarian yang dioptimalkan untuk penyedia peta situs saat mengambil simpul leluhur untuk objek yang ditentukan SiteMapNode dan mengambil simpul anaknya.

(Diperoleh dari SiteMapProvider)
GetRootNodeCore()

Mengambil simpul tingkat atas dari struktur data peta situs saat ini.

GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
HintAncestorNodes(SiteMapNode, Int32)

Menyediakan metode yang dapat diambil alih oleh penyedia peta situs untuk melakukan pengambilan yang dioptimalkan dari satu atau beberapa tingkat simpul induk dan leluhur, relatif terhadap objek yang ditentukan SiteMapNode .

(Diperoleh dari SiteMapProvider)
HintNeighborhoodNodes(SiteMapNode, Int32, Int32)

Menyediakan metode yang dapat diambil alih oleh penyedia peta situs untuk melakukan pengambilan simpul yang dioptimalkan yang ditemukan di kedekatan simpul yang ditentukan.

(Diperoleh dari SiteMapProvider)
Initialize(String, NameValueCollection)

Menginisialisasi objek XmlSiteMapProvider. Metode ini Initialize(String, NameValueCollection) tidak benar-benar membangun peta situs, hanya menyiapkan status XmlSiteMapProvider untuk melakukannya.

IsAccessibleToUser(HttpContext, SiteMapNode)

Mengambil nilai Boolean yang menunjukkan apakah objek yang ditentukan SiteMapNode dapat dilihat oleh pengguna dalam konteks yang ditentukan.

(Diperoleh dari SiteMapProvider)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
RemoveNode(SiteMapNode)

Menghapus objek yang ditentukan SiteMapNode dari semua koleksi simpul yang dilacak oleh penyedia.

RemoveProvider(String)

Menghapus penyedia peta situs anak tertaut dari hierarki untuk penyedia saat ini.

ResolveSiteMapNode(HttpContext)

Memunculkan kejadian SiteMapResolve.

(Diperoleh dari SiteMapProvider)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Acara

SiteMapResolve

Terjadi ketika CurrentNode properti dipanggil.

(Diperoleh dari SiteMapProvider)

Berlaku untuk

Lihat juga