XmlSiteMapProvider Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Klasa XmlSiteMapProvider pochodzi z SiteMapProvider klasy i jest domyślnym dostawcą mapy witryny dla ASP.NET. Klasa XmlSiteMapProvider generuje drzewa map witryn z plików XML z rozszerzeniem nazwy pliku .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

Dziedziczenie: Object

ProviderBase

SiteMapProvider

StaticSiteMapProvider
XmlSiteMapProvider

Implementuje: IDisposable

Uwagi

Klasa XmlSiteMapProvider ładuje dane mapy witryny z pliku XML, który jest zgodny ze znanym schematem. Dane mapy witryny są powiązane przez <siteMap> tagi i składają się z tagów zagnieżdżonych <siteMapNode> . Dwa ograniczenia są nakładane przez SiteMapProvider klasy i XmlSiteMapProvider na strukturę danych mapy witryny:

Może istnieć tylko jeden węzeł główny.
W przypadku SiteMapNode obiektów określających adresy URL adresy URL adresy URL muszą być unikatowe w zakresie dostawcy. (W przypadku węzłów, które nie określają adresów URL, wszystkie klucze muszą być unikatowe).

Poniższy przykład kodu przedstawia przykład pliku XML, który może być używany z .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>

Jest XmlSiteMapProvider to domyślny dostawca ASP.NET, który odczytuje dane XML z pliku o nazwie Web.sitemap, który znajduje się w strukturze katalogów aplikacji ASP.NET. Domyślnie plik Web.sitemap znajduje się w katalogu głównym aplikacji; Jeśli jednak chcesz zmienić nazwę lub lokalizację pliku, z którego XmlSiteMapProvider są ładowane dane, możesz zastąpić konfigurację domyślną w pliku Web.config. Przesłaniając domyślne ustawienia konfiguracji w pliku Web.config, można w razie potrzeby dostosować zachowanie XmlSiteMapProvider każdej aplikacji ASP.NET.

Poniższy przykład kodu przedstawia przykładowy plik Web.config, w którym XmlSiteMapProvider plik jest nadal używany, ale jest używany inny plik mapy witryny. Ponieważ wszyscy dostawcy w SiteMapProviderCollection obiekcie muszą być nazwani unikatowo, ten, który jest określony w pliku Web.config używa nazwy innej niż domyślna, ale jest również ustawiony jako dostawca domyślny, tak aby był używany zamiast XmlSiteMapProvider określony w domyślnej konfiguracji ASP.NET.

Uwaga

Możesz zmienić nazwę pliku danych nawigacji witryny, ale nie można zmienić jego rozszerzenia. Tylko XmlSiteMapProvider odczytuje dane z plików, które są nazwane z rozszerzeniem nazwy pliku .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>

Konstruktory

XmlSiteMapProvider()

Tworzy nowe, nienazwane wystąpienie XmlSiteMapProvider klasy .

Właściwości

CurrentNode	SiteMapNode Pobiera obiekt reprezentujący aktualnie żądaną stronę.
CurrentNode	SiteMapNode Pobiera obiekt reprezentujący aktualnie żądaną stronę. (Odziedziczone po SiteMapProvider)
Description	Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI). (Odziedziczone po ProviderBase)
EnableLocalization	Pobiera lub ustawia wartość logiczną wskazującą, czy zwracane są zlokalizowane wartości atrybutów SiteMapNode . (Odziedziczone po SiteMapProvider)
Name	Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji. (Odziedziczone po ProviderBase)
ParentProvider	Pobiera lub ustawia obiekt nadrzędny SiteMapProvider bieżącego dostawcy. (Odziedziczone po SiteMapProvider)
ResourceKey	Pobierz lub ustawia klucz zasobu używany do lokalizowania SiteMapNode atrybutów. (Odziedziczone po SiteMapProvider)
RootNode	Pobiera węzeł główny mapy witryny.
RootProvider	Pobiera obiekt główny SiteMapProvider w bieżącej hierarchii dostawcy. (Odziedziczone po SiteMapProvider)
SecurityTrimmingEnabled	Pobiera wartość logiczną wskazującą, czy dostawca mapy lokacji filtruje węzły mapy witryny na podstawie roli użytkownika. (Odziedziczone po SiteMapProvider)

Metody

AddNode(SiteMapNode)	SiteMapNode Dodaje obiekt do kolekcji węzłów obsługiwanej przez dostawcę mapy witryny. (Odziedziczone po SiteMapProvider)
AddNode(SiteMapNode, SiteMapNode)	SiteMapNode Dodaje obiekt do kolekcji, które są obsługiwane przez bieżącego dostawcę.
AddProvider(String, SiteMapNode)	Łączy podrzędnego dostawcę mapy witryny z bieżącym dostawcą.
BuildSiteMap()	Ładuje informacje o mapie witryny z pliku XML i kompiluje je w pamięci.
Clear()	Usuwa wszystkie elementy w kolekcjach węzłów podrzędnych i nadrzędnych węzłów mapy lokacji oraz dostawców mapy lokacji, które XmlSiteMapProvider obiekt wewnętrznie śledzi w ramach jego stanu.
Dispose()	Powiadamia monitor pliku web.sitemap, że XmlSiteMapProvider obiekt nie wymaga już monitorowania pliku.
Dispose(Boolean)	Powiadamia monitor pliku web.sitemap, że XmlSiteMapProvider obiekt nie wymaga już monitorowania pliku. Metoda Dispose(Boolean) przyjmuje parametr logiczny wskazujący, czy metoda jest wywoływana przez kod użytkownika.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindSiteMapNode(HttpContext)	SiteMapNode Pobiera obiekt reprezentujący aktualnie żądaną stronę przy użyciu określonego HttpContext obiektu. (Odziedziczone po SiteMapProvider)
FindSiteMapNode(String)	SiteMapNode Pobiera obiekt reprezentujący stronę pod określonym adresem URL.
FindSiteMapNodeFromKey(String)	SiteMapNode Pobiera obiekt na podstawie określonego klucza.
GetChildNodes(SiteMapNode)	Zwraca węzły podrzędne mapy lokacji.
GetChildNodes(SiteMapNode)	Pobiera podrzędne węzły mapy lokacji określonego SiteMapNode obiektu. (Odziedziczone po StaticSiteMapProvider)
GetCurrentNodeAndHintAncestorNodes(Int32)	Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców mapy witryny podczas pobierania węzła dla aktualnie żądanej strony i pobierania węzłów mapy witryny nadrzędnej i nadrzędnej dla bieżącej strony. (Odziedziczone po SiteMapProvider)
GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)	Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców mapy lokacji podczas pobierania węzła dla aktualnie żądanej strony i pobierania węzłów mapy witryny w pobliżu bieżącego węzła. (Odziedziczone po SiteMapProvider)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetParentNode(SiteMapNode)	Zwraca węzeł nadrzędny mapy witryny.
GetParentNode(SiteMapNode)	Pobiera węzeł mapy lokacji nadrzędnej określonego SiteMapNode obiektu. (Odziedziczone po StaticSiteMapProvider)
GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)	Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców mapy lokacji podczas pobierania węzła przodka dla aktualnie żądanej strony i pobierania węzłów podrzędnych dla obiektu nadrzędnym. (Odziedziczone po SiteMapProvider)
GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)	Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców mapy lokacji podczas pobierania węzła nadrzędnego dla określonego SiteMapNode obiektu i pobierania jego węzłów podrzędnych. (Odziedziczone po SiteMapProvider)
GetRootNodeCore()	Pobiera węzeł najwyższego poziomu bieżącej struktury danych mapy witryny.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HintAncestorNodes(SiteMapNode, Int32)	Udostępnia metodę, którą dostawcy mapy lokacji mogą zastąpić w celu przeprowadzenia zoptymalizowanego pobierania jednego lub większej liczby poziomów węzłów nadrzędnych i węzłów nadrzędnych względem określonego SiteMapNode obiektu. (Odziedziczone po SiteMapProvider)
HintNeighborhoodNodes(SiteMapNode, Int32, Int32)	Udostępnia metodę, którą dostawcy mapy lokacji mogą zastąpić w celu przeprowadzenia zoptymalizowanego pobierania węzłów znajdujących się w pobliżu określonego węzła. (Odziedziczone po SiteMapProvider)
Initialize(String, NameValueCollection)	Inicjuje XmlSiteMapProvider obiekt. Metoda Initialize(String, NameValueCollection) w rzeczywistości nie tworzy mapy witryny, przygotowuje tylko stan XmlSiteMapProvider , aby to zrobić.
IsAccessibleToUser(HttpContext, SiteMapNode)	Pobiera wartość logiczną wskazującą, czy określony SiteMapNode obiekt może być wyświetlany przez użytkownika w określonym kontekście. (Odziedziczone po SiteMapProvider)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RemoveNode(SiteMapNode)	Usuwa określony SiteMapNode obiekt ze wszystkich kolekcji węzłów śledzonych przez dostawcę.
RemoveProvider(String)	Usuwa połączonego podrzędnego dostawcę mapy lokacji z hierarchii bieżącego dostawcy.
ResolveSiteMapNode(HttpContext)	SiteMapResolve Zgłasza zdarzenie. (Odziedziczone po SiteMapProvider)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

SiteMapResolve

Występuje, gdy właściwość jest wywoływana CurrentNode .

(Odziedziczone po SiteMapProvider)

Dotyczy