XmlSiteMapProvider Kelas

Referensi

Definisi

Ruang nama:: System.Web

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.

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: Object

ProviderBase

SiteMapProvider

StaticSiteMapProvider
XmlSiteMapProvider

Penerapan: IDisposable

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 dapat 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 kelas baru yang tidak disebutkan XmlSiteMapProvider 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 ramah 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 Menambahkan objek ke kumpulan simpul yang dikelola oleh penyedia peta situs. (Diperoleh dari SiteMapProvider)
AddNode(SiteMapNode, SiteMapNode)	SiteMapNode Menambahkan objek ke koleksi yang dikelola oleh penyedia saat ini.
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 dari instans Type saat ini. (Diperoleh dari Object)
HintAncestorNodes(SiteMapNode, Int32)	Menyediakan metode yang dapat diambil alih 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 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) sebenarnya tidak 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 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