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.SiteMapNodePublic 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 .
