XmlSiteMapProvider.FindSiteMapNode(String) Method

Definition

Получает объект SiteMapNode, который представляет страницу по указанному URL-адресу.Retrieves a SiteMapNode object that represents the page at the specified 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

Parameters

rawUrl
String

URL-адрес, определяющий страницу, для которой необходимо извлечь SiteMapNode.A URL that identifies the page for which to retrieve a SiteMapNode.

Returns

SiteMapNode

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

Exceptions

Дочерний элемент поставщика связан с текущим поставщиком карты веб-узла, возвращенной недействительным узлом.A child provider linked to the current site map provider returned a node that is not valid.

Remarks

Объект XmlSiteMapProvider переопределяет метод FindSiteMapNode, чтобы обеспечить поиск узла всеми связанными дочерними поставщиками, если реализация базового класса не возвращает узел для указанного URL-адреса.The XmlSiteMapProvider object overrides the FindSiteMapNode method to ensure that any linked child providers are searched for the node if the implementation of the base class does not return a node for the specified URL.

Параметр rawUrl должен быть либо абсолютным виртуальным путем, либо путем относительно приложения, в зависимости от того, как он указан в файле данных схемы сайта XML.The rawUrl parameter should be either an absolute virtual path or an application-relative path, depending on how it is specified in the XML site map data file.

Класс XmlSiteMapProvider и классы, производные от него, используют URL-адрес объекта SiteMapNode в качестве ключа в различных коллекциях, поддерживаемых классом.The XmlSiteMapProvider class and classes that are derived from it use the URL of a SiteMapNode object as a key in the various collections that the class maintains. Поэтому эти URL-адреса должны быть уникальными в пределах области схемы узла.Therefore, these URLs must be unique within the scope of the site map. Если URL-адрес не найден в непосредственных данных схемы сайта, управляемых XmlSiteMapProvider, он вызывает FindSiteMapNode для каждого дочернего поставщика, связанного с ним через атрибут provider узлов карт узла.If the URL is not found within the immediate site map data that is managed by the XmlSiteMapProvider, it calls the FindSiteMapNode on each child provider that is linked to it through the provider attribute of its site map nodes.

Метод FindSiteMapNode косвенно вызывает метод BuildSiteMap для получения узла верхнего уровня в карте узла.The FindSiteMapNode method indirectly calls the BuildSiteMap method to retrieve the top-level node in the site map. Таким образом, любые исключения, возникающие для метода BuildSiteMap, также могут возникать при вызове метода FindSiteMapNode.Therefore, any exceptions that occur for the BuildSiteMap method can also occur when calling the FindSiteMapNode method.

Applies to

See also