XmlSiteMapProvider.FindSiteMapNodeFromKey(String) 메서드

정의

지정된 키를 기반으로 SiteMapNode 개체를 검색합니다.Retrieves a SiteMapNode object based on a specified key.

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를 검색하는 데 사용할 조회 키입니다.A lookup key with which to search for a SiteMapNode.

반환

SiteMapNode로 식별되는 페이지를 나타내는 key입니다. 보안 트리밍이 사용되고 현재 사용자에게 노드가 표시되지 않거나 노드 컬렉션에서 노드를 null로 찾을 수 없는 경우에는 key입니다.A SiteMapNode that represents the page identified by key; otherwise, null, if security trimming is enabled and the node cannot be shown to the current user or the node is not found by key in the node collection.

예외

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

설명

XmlSiteMapProvider 클래스는 FindSiteMapNodeFromKey 메서드를 재정의 하 여 기본 클래스에 대 한 구현에서 key에 대 한 노드를 반환 하지 않는 경우 모든 연결 된 자식 공급자가 노드를 검색 하는지 확인 합니다.The XmlSiteMapProvider class overrides the FindSiteMapNodeFromKey method to ensure that any linked child providers are searched for the node, if the implementation for the base class does not return a node for key.

ASP.NET의 StaticSiteMapProvider 클래스 및 기본 사이트 맵 공급자에서 파생 된 XmlSiteMapProvider 개체는 기본적으로 SiteMapNode 개체의 Url 속성을 내부 컬렉션의 조회 키로 사용 합니다.The XmlSiteMapProvider object, derived from the StaticSiteMapProvider class and 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. SiteMapNodeUrl 속성이 설정 된 경우 공급자의 범위 내에서 고유 해야 합니다.If the Url property of the SiteMapNode is set, it must be unique within the scope of the provider. Url 지정 하지 않으면 XmlSiteMapProvider 자동으로 Key를 생성 하 여 노드를 추적 합니다.If no Url is specified, the XmlSiteMapProvider automatically generates a Key to track the nodes.

FindSiteMapNodeFromKey 메서드는 현재 공급자와 연결 된 모든 자식 공급자에서 BuildSiteMap 메서드를 호출할 수 있습니다.The FindSiteMapNodeFromKey method might call the BuildSiteMap method on any child providers that are associated with the current provider. 따라서 BuildSiteMap 메서드에 설명 된 예외가 throw 될 수 있습니다.Therefore, the exceptions that are described in the BuildSiteMap method might be thrown.

적용 대상

추가 정보