XmlSiteMapProvider.FindSiteMapNodeFromKey(String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 키를 기반으로 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를 검색하는 데 사용할 조회 키입니다.
반환
key
로 식별되는 페이지를 나타내는 SiteMapNode입니다. 보안 트리밍이 사용되고 현재 사용자에게 노드가 표시되지 않거나 노드 컬렉션에서 노드를 key
로 찾을 수 없는 경우에는 null
입니다.
예외
현재 사이트 맵 공급자에 연결된 자식 공급자가 잘못된 노드를 반환한 경우
설명
XmlSiteMapProvider클래스는 메서드를 재정의 FindSiteMapNodeFromKey 하 여 기본 클래스에 대 한 구현이에 대 한 노드를 반환 하지 않는 경우 모든 연결 된 자식 공급자가 노드를 검색 key
하도록 합니다.
XmlSiteMapProvider클래스에서 파생 된 개체 StaticSiteMapProvider 와 ASP.NET에 대 한 기본 사이트 맵 공급자는 Url 기본적으로 개체의 속성을 SiteMapNode 내부 컬렉션의 조회 키로 사용 합니다. Url의 속성이 설정 된 경우 SiteMapNode 공급자의 범위 내에서 고유 해야 합니다. 을 지정 하지 않으면 Url 에서 XmlSiteMapProvider 자동으로을 생성 Key 하 여 노드를 추적 합니다.
FindSiteMapNodeFromKey메서드는 BuildSiteMap 현재 공급자와 연결 된 모든 자식 공급자에서 메서드를 호출할 수 있습니다. 따라서 메서드에 설명 된 예외가 BuildSiteMap throw 될 수 있습니다.