StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

SiteMapNode Pobiera obiekt na podstawie określonego klucza.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);

public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);

override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode

Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parametry

key

String

Klucz odnośnika SiteMapNode , za pomocą którego jest tworzony element .

Zwraca

SiteMapNode

Element SiteMapNode reprezentujący stronę zidentyfikowaną przez keyelement ; w przeciwnym razie , nulljeśli jest włączone przycinanie zabezpieczeń, a węzeł mapy witryny nie może być wyświetlany bieżącemu użytkownikowi lub węzeł mapy witryny nie zostanie znaleziony w zbiorze węzłów mapy witryny przez key.

Uwagi

Metoda FindSiteMapNodeFromKey pobiera węzeł mapy witryny z obiektu wewnętrznego Hashtable na keypodstawie .

Obiekt XmlSiteMapProvider , który pochodzi z StaticSiteMapProvider klasy i jest domyślnym dostawcą mapy witryny dla ASP.NET, domyślnie używa Url właściwości SiteMapNode obiektu jako klucza odnośnika w jego kolekcjach wewnętrznych. Url Jeśli właściwość obiektu SiteMapNode jest ustawiona, musi być unikatowa w zakresie dostawcy mapy witryny. Metoda FindSiteMapNode próbuje pobrać węzły mapy lokacji na podstawie ich Url. W przeciwnym razie możesz użyć Key właściwości i odpowiedniej FindSiteMapNodeFromKey metody w celu pobrania węzłów mapy witryny.

Element StaticSiteMapProvider ma domyślną implementację, która wyszukuje SiteMapNode wystąpienia klasy na podstawie parametru key . Jeśli implementator dostawcy mapy lokacji użył AddNode metody , StaticSiteMapProvider będzie już przechowywać odwołanie do każdej SiteMapNode z nich na podstawie wartości SiteMapNode.Key właściwości. Domyślnie funkcja XmlSiteMapProvider generuje identyfikatory GUID dla wystąpień SiteMapNode klasy, które nie mają wartości dla SiteMapNode.Url właściwości . Niestandardowe implementatory dostawcy map lokacji muszą zapewnić własny mechanizm generowania unikatowych wartości SiteMapNode.Key właściwości w przypadku, gdy wystąpienie SiteMapNode klasy nie ma wartości właściwości SiteMapNode.Url .

Klasy SiteMapProvider i XmlSiteMapProvider , które są domyślną implementacją dostawcy mapy witryny dla ASP.NET, używają adresu URL SiteMapNode obiektu jako klucza w różnych kolekcjach, które są obsługiwane przez klasy.

Zobacz też

• FindSiteMapNode