StaticSiteMapProvider.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 a SiteMapNode is created.

반환

SiteMapNode

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

설명

합니다 FindSiteMapNodeFromKey 메서드 내부에서 사이트 맵 노드를 검색 Hashtable 개체에 따라 key합니다.The FindSiteMapNodeFromKey method retrieves a site map node from an internal Hashtable object based on key.

XmlSiteMapProvider 에서 파생 된 개체를 StaticSiteMapProvider 클래스 및 ASP.NET에 대 한 기본 사이트 맵 공급자를 사용 하 여는 Url 의 속성을 SiteMapNode 기본적으로 내부 컬렉션을 조회 키로 개체.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider class 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.

StaticSiteMapProvider 의 인스턴스를 조회 하는 기본 구현을 합니다 SiteMapNode 클래스에 따라는 key 매개 변수입니다.The StaticSiteMapProvider has a default implementation that looks up instances of the SiteMapNode class based on the key parameter. 경우 사용 하는 사이트 맵 제공자 구현자는 AddNode 메서드를 StaticSiteMapProvider 저장 하 게 됩니다 각각에 대 한 참조 SiteMapNode 의 값을 기반으로 SiteMapNode.Key 속성.If a site map provider implementer used the AddNode method, the StaticSiteMapProvider already will have stored a reference to each SiteMapNode based on the value of the SiteMapNode.Key property. 기본적으로 XmlSiteMapProvider 에 대 한 Guid를 생성의 인스턴스를 SiteMapNode 클래스에 대 한 값이 없는 SiteMapNode.Url 속성입니다.By default, the XmlSiteMapProvider generates GUIDs for instances of the SiteMapNode class that do not have a value for the SiteMapNode.Url property. 사용자 지정 사이트 맵 공급자 구현자의 고유한 값을 생성 하기 위한 고유한 메커니즘을 제공 해야 합니다는 SiteMapNode.Key 속성에서의 인스턴스를 SiteMapNode 클래스에 대 한 값이 없는 SiteMapNode.Url 속성.Custom site map provider implementers must provide their own mechanism for generating unique values of the SiteMapNode.Key property in the event that an instance of the SiteMapNode class does not have a value for the SiteMapNode.Url property.

SiteMapProvider 하 고 XmlSiteMapProvider 의 URL을 사용 하는 클래스는 ASP.NET의 기본 사이트 맵 공급자 구현을 SiteMapNode 개체 클래스를 유지 관리 하는 다양 한 컬렉션의 키로 합니다.The SiteMapProvider and XmlSiteMapProvider classes, which are the default site map provider implementation for ASP.NET, use the URL of a SiteMapNode object as a key in the various collections that the classes maintain.

적용 대상

추가 정보