XmlSiteMapProvider.FindSiteMapNode(String) 메서드

정의

지정된 URL의 페이지를 나타내는 SiteMapNode 개체를 검색합니다.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

매개 변수

rawUrl
String

SiteMapNode를 검색할 페이지를 식별하는 URL입니다.A URL that identifies the page for which to retrieve a SiteMapNode.

반환

SiteMapNode로 식별하는 페이지를 나타내는 rawURL입니다.A SiteMapNode that represents the page identified by rawURL.

예외

현재 사이트 맵 공급자에 연결된 자식 공급자가 잘못된 노드를 반환한 경우A child provider linked to the current site map provider returned a node that is not valid.

설명

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 클래스 및 클래스는 클래스에서 유지 관리 하는 다양 한 컬렉션에서 SiteMapNode 개체의 URL을 키로 사용 합니다.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. XmlSiteMapProvider에서 관리 하는 즉시 사이트 맵 데이터 내에서 URL을 찾을 수 없는 경우 해당 사이트 맵 노드의 provider 특성을 통해 연결 된 각 자식 공급자에서 FindSiteMapNode를 호출 합니다.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.

적용 대상

추가 정보