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


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.SiteMapNode
Public 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 объекта в качестве ключа в различных коллекциях, которые поддерживаются классами.

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

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