XmlSiteMapProvider.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로 식별되는 페이지를 나타내는 SiteMapNode입니다. 보안 트리밍이 사용되고 현재 사용자에게 노드가 표시되지 않거나 노드 컬렉션에서 노드를 key로 찾을 수 없는 경우에는 null입니다.

예외

현재 사이트 맵 공급자에 연결된 자식 공급자가 잘못된 노드를 반환한 경우

설명

XmlSiteMapProvider클래스는 메서드를 재정의 FindSiteMapNodeFromKey 하 여 기본 클래스에 대 한 구현이에 대 한 노드를 반환 하지 않는 경우 모든 연결 된 자식 공급자가 노드를 검색 key 하도록 합니다.

XmlSiteMapProvider클래스에서 파생 된 개체 StaticSiteMapProvider 와 ASP.NET에 대 한 기본 사이트 맵 공급자는 Url 기본적으로 개체의 속성을 SiteMapNode 내부 컬렉션의 조회 키로 사용 합니다. Url의 속성이 설정 된 경우 SiteMapNode 공급자의 범위 내에서 고유 해야 합니다. 을 지정 하지 않으면 Url 에서 XmlSiteMapProvider 자동으로을 생성 Key 하 여 노드를 추적 합니다.

FindSiteMapNodeFromKey메서드는 BuildSiteMap 현재 공급자와 연결 된 모든 자식 공급자에서 메서드를 호출할 수 있습니다. 따라서 메서드에 설명 된 예외가 BuildSiteMap throw 될 수 있습니다.

적용 대상

추가 정보