StaticSiteMapProvider.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.
Комментарии
Метод FindSiteMapNodeFromKey извлекает узел карты сайта из внутреннего Hashtable объекта на keyоснове .
Объект XmlSiteMapProvider , производный StaticSiteMapProvider от класса и являющийся поставщиком карты сайта по умолчанию для ASP.NET, по умолчанию использует Url свойство объекта в качестве ключа подстановки SiteMapNode во внутренних коллекциях. Url Если задано свойство SiteMapNode объекта , оно должно быть уникальным в пределах области действия поставщика карты сайта. Метод FindSiteMapNode пытается получить узлы карты сайта на основе их Url. В противном случае можно использовать Key свойство и соответствующий FindSiteMapNodeFromKey метод для получения узлов карты сайта.
Имеет StaticSiteMapProvider реализацию по умолчанию, которая ищет экземпляры SiteMapNode класса на key основе параметра . Если поставщик карты сайта использовал AddNode метод , StaticSiteMapProvider объект уже будет хранить ссылку на каждый из них SiteMapNode на основе значения SiteMapNode.Key свойства . По умолчанию XmlSiteMapProvider создает идентификаторы GUID для экземпляров SiteMapNode класса , у которых нет значения свойства SiteMapNode.Url . Поставщики пользовательских карт сайтов должны предоставлять собственный механизм для создания уникальных значений SiteMapNode.Key свойства в случае, если экземпляр SiteMapNode класса не имеет значения для SiteMapNode.Url свойства .
Классы SiteMapProvider и XmlSiteMapProvider , которые являются реализацией поставщика карты сайта по умолчанию для ASP.NET, используют URL-адрес SiteMapNode объекта в качестве ключа в различных коллекциях, которые поддерживаются классами.
