Поделиться через


XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Метод

Определение

Получает объект SiteMapNode на основе указанного ключа.

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

Параметры

key
String

Ключ поиска, с которым проходит поиск узла SiteMapNode.

Возвращаемое значение

Объект SiteMapNode, который представляет страницу, идентифицированную параметром key; в противном случае — значение null, если фильтрация по ролям безопасности включена и узел не может быть показан текущему пользователю или узел не найден ключом key в коллекции узлов.

Исключения

Дочерний элемент поставщика связан с текущим поставщиком карты веб-узла, возвращенной недействительным узлом.

Комментарии

Класс XmlSiteMapProvider переопределяет FindSiteMapNodeFromKey метод , чтобы обеспечить поиск узла во всех связанных дочерних поставщиках, если реализация базового класса не возвращает узел для key.

Объект XmlSiteMapProvider , производный StaticSiteMapProvider от класса и поставщика карты сайта по умолчанию для ASP.NET, по умолчанию использует Url свойство объекта в качестве ключа подстановки SiteMapNode во внутренних коллекциях. Url Если свойство объекта заданоSiteMapNode, оно должно быть уникальным в пределах области действия поставщика. Если значение не Url указано, XmlSiteMapProvider объект автоматически создает Key для отслеживания узлов.

Метод FindSiteMapNodeFromKey может вызывать метод для BuildSiteMap любых дочерних поставщиков, связанных с текущим поставщиком. Поэтому могут возникать исключения, описанные в методе BuildSiteMap .

Применяется к

См. также раздел