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 .