StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Metoda
Definicja
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.
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.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParametry
- key
- String
Klucz odnośnika SiteMapNode , za pomocą którego jest tworzony element .
Zwraca
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.
