StaticSiteMapProvider.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로 식별되는 페이지를 나타내는 SiteMapNode이고, 해당 사이트 맵 노드가 없으면 null입니다.A SiteMapNode that represents the page identified by rawURL; otherwise, null, if no corresponding site map node is found.

예외

rawURL이(가) null인 경우rawURL is null.

설명

제공된 된 URL은 일반적으로 가상 또는 절대 URL입니다.The provided URL is typically a virtual or absolute URL. 와 같은 ASP.NET 애플리케이션에 상대적인 구문을 사용 하는 URL 일 수도 있습니다 "~/apprelativedirectory"합니다.It can also be a URL that uses ASP.NET application-relative syntax, such as "~/apprelativedirectory". StaticSiteMapProvider 클래스를 절대 가상 경로로 애플리케이션에 상대적인 원시 Url을 자동으로 정규화 합니다.The StaticSiteMapProvider class automatically normalizes application-relative raw URLs to an absolute virtual path.

XmlSiteMapProvider 에서 파생 된 개체를 StaticSiteMapProvider 및 ASP.NET에 대 한 기본 사이트 맵 공급자를 사용 하 여는 Url 의 속성을 SiteMapNode 기본적으로 내부 컬렉션을 조회 키로 개체.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. 경우는 Url 의 속성을 SiteMapNode 설정, 사이트 맵 공급자의 범위 내에서 고유 해야 합니다.If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. 합니다 FindSiteMapNode 메서드를 기반으로 하는 사이트 맵 노드를 검색 하려고 합니다. 해당 Url합니다.The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. 그렇지 않으면 사용할 수 있습니다 합니다 Key 속성과 해당 FindSiteMapNodeFromKey 사이트 맵 노드를 검색 하는 방법입니다.Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. 없으면 Url 또는 Key 가 지정, 사이트 맵 공급자가 자동으로 생성 된 Key 사이트 맵 노드를 추적 하는 속성입니다.If no Url or Key is specified, the site map provider automatically generates a Key property to track the site map nodes.

상속자 참고

재정의 하는 경우는 FindSiteMapNode(String) 파생된 클래스에서 메서드를의 Url을 정규화 해야 합니다 SiteMapNode 사이트 맵 공급자를 추가 하는 개체 있도록는 FindSiteMapNode(String) 여부에 관계 없이 사이트 맵 노드를 검색할 수 사이트 맵에 대 한 URL 노드는 애플리케이션 상대 경로 또는 절대 가상 경로가 제공 됩니다.When overriding the FindSiteMapNode(String) method in a derived class, be sure to normalize the URLs of the SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode(String) method can retrieve a site map node regardless of whether URL for the site map node is supplied as an absolute virtual path or an application relative path.

보안 조정 동작에 포함 되어는 SiteMapProviderStaticSiteMapProvider 클래스 구현 합니다.Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. 그러나 파생된 클래스에서 함수를 보안 트리밍이 설정 해야 합니다는 Roles 속성을 SiteMapNode 재정의 하는 경우 사이트 맵 공급자를 빌드하는 동안 만든 개체는 BuildSiteMap() 메서드.However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap() method.

적용 대상

추가 정보