XmlSiteMapProvider.FindSiteMapNode(String) Метод

Определение

Получает объект SiteMapNode, который представляет страницу по указанному URL-адресу.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode (string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Параметры

rawUrl
String

URL-адрес, определяющий страницу, для которой необходимо извлечь SiteMapNode.

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

Объект SiteMapNode, представляющий страницу, идентифицированную параметром rawURL.

Исключения

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

Комментарии

Объект XmlSiteMapProvider переопределяет FindSiteMapNode метод , чтобы обеспечить поиск узла всех связанных дочерних поставщиков, если реализация базового класса не возвращает узел для указанного URL-адреса.

Параметр rawUrl должен быть либо абсолютным виртуальным путем, либо относительным для приложения путем в зависимости от того, как он указан в XML-файле данных карты сайта.

Класс XmlSiteMapProvider и классы, производные от него, используют URL-адрес SiteMapNode объекта в качестве ключа в различных коллекциях, которые поддерживает класс. Таким образом, эти URL-адреса должны быть уникальными в области карты сайта. Если URL-адрес не найден в непосредственных данных карты сайта, которыми XmlSiteMapProviderуправляет , он вызывает FindSiteMapNode для каждого дочернего поставщика, связанного с ним через provider атрибут его узлов карты сайта.

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

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

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