XmlSiteMapProvider XmlSiteMapProvider XmlSiteMapProvider XmlSiteMapProvider Class

정의

XmlSiteMapProvider 클래스는 SiteMapProvider 클래스에서 파생되며 ASP.NET에 대한 기본 사이트 맵 제공자입니다.The XmlSiteMapProvider class is derived from the SiteMapProvider class and is the default site map provider for ASP.NET. XmlSiteMapProvider 클래스는 파일 이름 확장명이 .sitemap인 XML 파일로 사이트 맵 트리를 생성합니다.The XmlSiteMapProvider class generates site map trees from XML files with the file name extension .sitemap.

public ref class XmlSiteMapProvider : System::Web::StaticSiteMapProvider, IDisposable
public class XmlSiteMapProvider : System.Web.StaticSiteMapProvider, IDisposable
type XmlSiteMapProvider = class
    inherit StaticSiteMapProvider
    interface IDisposable
Public Class XmlSiteMapProvider
Inherits StaticSiteMapProvider
Implements IDisposable
상속
구현

설명

XmlSiteMapProvider 클래스는 알려진된 스키마를 따르는 XML 파일에서 사이트 맵 데이터를 로드 합니다.The XmlSiteMapProvider class loads site map data from an XML file that follows a known schema. 사이트 맵 데이터에 의해 제한 됩니다 <siteMap> 태그를 지정 하 고 구성 중첩 <siteMapNode> 태그입니다.The site map data is bounded by <siteMap> tags and consists of nested <siteMapNode> tags. 두 가지 제약 조건이 적용 되는 SiteMapProviderXmlSiteMapProvider 사이트의 구조에 클래스 매핑 데이터:Two constraints are imposed by the SiteMapProvider and XmlSiteMapProvider classes on the structure of the site map data:

  • 하나의 루트 노드에 있을 수 있습니다.Only one root node can exist.

  • 에 대 한 SiteMapNode 지정 Url, Url 공급자의 범위 내에서 고유 해야 하는 개체입니다.For SiteMapNode objects that specify URLs, the URLs must be unique within the scope of the provider. (노드의 Url을 지정 하지 않는 경우 모든 키는 고유 해야 합니다.)(For nodes that do not specify URLs, all keys must be unique.)

다음 코드 예제에서는 사용할 수 있는 XML 파일의 예를 보여 줍니다.는 XmlSiteMapProvider합니다.The following code example shows an example of an XML file that can be used with the XmlSiteMapProvider.

<siteMap>  
  <siteMapNode title="RootNode" description="This is the root node of the site map. There can be only one root node." url="Page1.aspx" >  
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page2.aspx">  
      <siteMapNode title="ChildOfChildNode" description="SiteMapNode objects can be nested to any level." url="Page3.aspx"/>  
    </siteMapNode>  
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page4.aspx"/>  
  </siteMapNode>  
</siteMap>  

XmlSiteMapProvider ASP.NET에 대 한 기본 공급자 이며 ASP.NET 애플리케이션의 디렉터리 구조 내에 있는 Web.sitemap 이라는 파일에서 XML 데이터를 읽는 합니다.The XmlSiteMapProvider is the default provider for ASP.NET and it reads XML data from a file named Web.sitemap that is located within the directory structure of the ASP.NET application. 기본적으로 Web.sitemap 파일에 위치한 애플리케이션 루트입니다. 그러나 이름 또는 파일의 위치를 변경 하려는 경우는 XmlSiteMapProvider 데이터를 로드 합니다. Web.config 파일의 기본 구성을 재정의할 수 있습니다.By default, the Web.sitemap file is located at the application root; however, if you want to change the name or location of the file from which the XmlSiteMapProvider loads data, you can override the default configuration in your Web.config file. Web.config 파일의 기본 구성 설정을 재정의 하 여 동작을 조정할 수 있습니다는 XmlSiteMapProvider 필요에 따라 각 ASP.NET 애플리케이션에 대 한 합니다.By overriding the default configuration settings in your Web.config file, you can tailor the behavior of the XmlSiteMapProvider for each ASP.NET application, as necessary.

다음 코드 예제는 예제 Web.config 파일을 보여 줍니다. 여기서는 XmlSiteMapProvider 계속 사용 하지만 다른 사이트 맵 파일을 사용 합니다.The following code example demonstrates an example Web.config file, where the XmlSiteMapProvider is still used, but a different site map file is used. 때문에 모든 공급자는 SiteMapProviderCollection 개체를 고유 하 게 지정 해야 합니다, Web.config 파일에 지정 된 기본값 이외의 다른 이름을 사용 하지만 대신 사용할 수는 기본 공급자로 설정는 XmlSiteMapProvider 에 지정 된 번째 즉 e 기본 ASP.NET 구성 합니다.Because all providers in a SiteMapProviderCollection object must be named uniquely, the one that is specified in the Web.config file uses a name other than the default but is also set as the default provider so that it will be used instead of the XmlSiteMapProvider that is specified in the default ASP.NET configuration.

참고

사이트 탐색 데이터 파일의 이름을 변경할 수 있지만 해당 확장을 변경할 수 없습니다.You can change the name of the site navigation data file, but you cannot change its extension. XmlSiteMapProvider 만 파일 이름 확장명이.sitemap 인 명명 된 파일에서 데이터를 읽습니다.The XmlSiteMapProvider only reads data from files that are named with the file name extension .sitemap.

<siteMap defaultProvider="MyXmlSiteMapProvider" enabled="true">  
  <providers>  
    <add name="MyXmlSiteMapProvider"  
      description="SiteMap provider that reads in .sitemap files."  
      type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"  
      siteMapFile="CustomWeb.sitemap" />  
  </providers>  
</siteMap>  

생성자

XmlSiteMapProvider() XmlSiteMapProvider() XmlSiteMapProvider() XmlSiteMapProvider()

XmlSiteMapProvider 클래스의 명명되지 않은 새 인스턴스를 만듭니다.Creates a new, unnamed, instance of the XmlSiteMapProvider class.

속성

CurrentNode CurrentNode CurrentNode CurrentNode

현재 요청된 페이지를 나타내는 SiteMapNode 개체를 가져옵니다.Gets the SiteMapNode object that represents the currently requested page.

Description Description Description Description

관리 도구나 다른 UI(사용자 인터페이스)에 표시하기에 적합한 간단하고 이해하기 쉬운 설명을 가져옵니다.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
EnableLocalization EnableLocalization EnableLocalization EnableLocalization

SiteMapNode 특성의 지역화된 값을 반환할지 여부를 나타내는 부울 값을 가져오거나 설정합니다.Gets or sets a Boolean value indicating whether localized values of SiteMapNode attributes are returned.

(Inherited from SiteMapProvider)
Name Name Name Name

구성 중 공급자를 참조하는 데 사용되는 이름을 가져옵니다.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)
ParentProvider ParentProvider ParentProvider ParentProvider

현재 공급자의 부모 SiteMapProvider 개체를 가져오거나 설정합니다.Gets or sets the parent SiteMapProvider object of the current provider.

(Inherited from SiteMapProvider)
ResourceKey ResourceKey ResourceKey ResourceKey

SiteMapNode 특성을 지역화하는 데 사용되는 리소스 키를 가져오거나 설정합니다.Get or sets the resource key that is used for localizing SiteMapNode attributes.

(Inherited from SiteMapProvider)
RootNode RootNode RootNode RootNode

사이트 맵의 루트 노드를 가져옵니다.Gets the root node of the site map.

RootProvider RootProvider RootProvider RootProvider

현재 공급자 계층 구조의 루트 SiteMapProvider 개체를 가져옵니다.Gets the root SiteMapProvider object in the current provider hierarchy.

(Inherited from SiteMapProvider)
SecurityTrimmingEnabled SecurityTrimmingEnabled SecurityTrimmingEnabled SecurityTrimmingEnabled

사이트 맵 공급자가 사용자 역할을 기반으로 사이트 맵 노드를 필터링할지 여부를 나타내는 부울 값을 가져옵니다.Gets a Boolean value indicating whether a site map provider filters site map nodes based on a user's role.

(Inherited from SiteMapProvider)

메서드

AddNode(SiteMapNode) AddNode(SiteMapNode) AddNode(SiteMapNode) AddNode(SiteMapNode)

사이트 맵 공급자가 유지 관리하는 노드 컬렉션에 SiteMapNode 개체를 추가합니다.Adds a SiteMapNode object to the node collection that is maintained by the site map provider.

(Inherited from SiteMapProvider)
AddNode(SiteMapNode, SiteMapNode) AddNode(SiteMapNode, SiteMapNode) AddNode(SiteMapNode, SiteMapNode) AddNode(SiteMapNode, SiteMapNode)

현재 공급자가 관리하는 컬렉션에 SiteMapNode 개체를 추가합니다.Adds a SiteMapNode object to the collections that are maintained by the current provider.

AddProvider(String, SiteMapNode) AddProvider(String, SiteMapNode) AddProvider(String, SiteMapNode) AddProvider(String, SiteMapNode)

하위 사이트 맵 공급자를 현재 공급자에 연결합니다.Links a child site map provider to the current provider.

BuildSiteMap() BuildSiteMap() BuildSiteMap() BuildSiteMap()

XML 파일로부터 사이트 맵 정보를 로드하여 메모리에 빌드합니다.Loads the site map information from an XML file and builds it in memory.

Clear() Clear() Clear() Clear()

자식 및 부모 사이트 맵 노드 컬렉션의 모든 요소와 내부적으로 XmlSiteMapProvider 개체가 해당 상태의 일부로 추적하는 사이트 맵 공급자를 제거합니다.Removes all elements in the collections of child and parent site map nodes and site map providers that the XmlSiteMapProvider object internally tracks as part of its state.

Dispose() Dispose() Dispose() Dispose()

XmlSiteMapProvider 개체가 더 이상 파일 모니터링을 요구하지 않는다는 것을 Web.sitemap 파일의 파일 모니터에 알립니다.Notifies the file monitor of the Web.sitemap file that the XmlSiteMapProvider object no longer requires the file to be monitored.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

XmlSiteMapProvider 개체가 더 이상 파일 모니터링을 요구하지 않는다는 것을 Web.sitemap 파일의 파일 모니터에 알립니다.Notifies the file monitor of the Web.sitemap file that the XmlSiteMapProvider object no longer requires the file to be monitored. Dispose(Boolean) 메서드는 사용자 코드가 메서드를 호출하는지 여부를 나타내는 부울 매개 변수를 사용합니다.The Dispose(Boolean) method takes a Boolean parameter indicating whether the method is called by user code.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindSiteMapNode(HttpContext) FindSiteMapNode(HttpContext) FindSiteMapNode(HttpContext) FindSiteMapNode(HttpContext)

지정한 SiteMapNode 개체를 사용하여 현재 요청된 페이지를 나타내는 HttpContext 개체를 검색합니다.Retrieves a SiteMapNode object that represents the currently requested page using the specified HttpContext object.

(Inherited from SiteMapProvider)
FindSiteMapNode(String) FindSiteMapNode(String) FindSiteMapNode(String) FindSiteMapNode(String)

지정된 URL의 페이지를 나타내는 SiteMapNode 개체를 검색합니다.Retrieves a SiteMapNode object that represents the page at the specified URL.

FindSiteMapNodeFromKey(String) FindSiteMapNodeFromKey(String) FindSiteMapNodeFromKey(String) FindSiteMapNodeFromKey(String)

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

GetChildNodes(SiteMapNode) GetChildNodes(SiteMapNode) GetChildNodes(SiteMapNode) GetChildNodes(SiteMapNode)

사이트 맵의 자식 노드를 반환합니다.Returns the child nodes of the site map.

GetCurrentNodeAndHintAncestorNodes(Int32) GetCurrentNodeAndHintAncestorNodes(Int32) GetCurrentNodeAndHintAncestorNodes(Int32) GetCurrentNodeAndHintAncestorNodes(Int32)

현재 요청된 페이지의 노드를 검색하고 현재 페이지의 부모 및 상위 사이트 맵 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the parent and ancestor site map nodes for the current page.

(Inherited from SiteMapProvider)
GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)

현재 요청된 페이지의 노드를 검색하고 현재 노드와 근접한 위치에서 사이트 맵 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the site map nodes in the proximity of the current node.

(Inherited from SiteMapProvider)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetParentNode(SiteMapNode) GetParentNode(SiteMapNode) GetParentNode(SiteMapNode) GetParentNode(SiteMapNode)

사이트 맵의 부모 노드를 반환합니다.Returns the parent node of the site map.

GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32) GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32) GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32) GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)

현재 요청된 페이지의 상위 노드를 검색하고 상위 노드에 대한 하위 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving an ancestor node for the currently requested page and fetching the descendant nodes for the ancestor.

(Inherited from SiteMapProvider)
GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32) GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32) GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32) GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)

지정된 SiteMapNode 개체에 대한 상위 노드를 검색하고 해당 자식 노드를 페치할 때 사이트 맵 공급자에 최적화된 조회 방법을 제공합니다.Provides an optimized lookup method for site map providers when retrieving an ancestor node for the specified SiteMapNode object and fetching its child nodes.

(Inherited from SiteMapProvider)
GetRootNodeCore() GetRootNodeCore() GetRootNodeCore() GetRootNodeCore()

현재 사이트 맵 데이터 구조의 최상위 노드를 검색합니다.Retrieves the top-level node of the current site map data structure.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
HintAncestorNodes(SiteMapNode, Int32) HintAncestorNodes(SiteMapNode, Int32) HintAncestorNodes(SiteMapNode, Int32) HintAncestorNodes(SiteMapNode, Int32)

지정된 SiteMapNode 개체를 기준으로 하여 부모 및 상위 노드의 여러 수준을 최적화 상태로 검색하기 위해 사이트 맵 공급자가 재정의할 수 있는 메서드를 제공합니다.Provides a method that site map providers can override to perform an optimized retrieval of one or more levels of parent and ancestor nodes, relative to the specified SiteMapNode object.

(Inherited from SiteMapProvider)
HintNeighborhoodNodes(SiteMapNode, Int32, Int32) HintNeighborhoodNodes(SiteMapNode, Int32, Int32) HintNeighborhoodNodes(SiteMapNode, Int32, Int32) HintNeighborhoodNodes(SiteMapNode, Int32, Int32)

사이트 맵 공급자가 지정된 노드와 근접한 위치에 있는 노드에 대해 최적화된 검색을 수행하기 위해 재정의할 수 있는 메서드를 제공합니다.Provides a method that site map providers can override to perform an optimized retrieval of nodes found in the proximity of the specified node.

(Inherited from SiteMapProvider)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

XmlSiteMapProvider 개체를 초기화합니다.Initializes the XmlSiteMapProvider object. Initialize(String, NameValueCollection) 메서드는 실제로 사이트 맵을 빌드하는 것이 아니라 단지 사이트 맵을 빌드하기 위해 XmlSiteMapProvider 상태를 준비합니다.The Initialize(String, NameValueCollection) method does not actually build a site map, it only prepares the state of the XmlSiteMapProvider to do so.

IsAccessibleToUser(HttpContext, SiteMapNode) IsAccessibleToUser(HttpContext, SiteMapNode) IsAccessibleToUser(HttpContext, SiteMapNode) IsAccessibleToUser(HttpContext, SiteMapNode)

사용자가 지정된 컨텍스트에서 지정된 SiteMapNode 개체를 볼 수 있는지 여부를 나타내는 부울 값을 검색합니다.Retrieves a Boolean value indicating whether the specified SiteMapNode object can be viewed by the user in the specified context.

(Inherited from SiteMapProvider)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveNode(SiteMapNode) RemoveNode(SiteMapNode) RemoveNode(SiteMapNode) RemoveNode(SiteMapNode)

공급자가 추적하는 모든 노드 컬렉션에서 지정된 SiteMapNode 개체를 제거합니다.Removes the specified SiteMapNode object from all node collections that are tracked by the provider.

RemoveProvider(String) RemoveProvider(String) RemoveProvider(String) RemoveProvider(String)

현재 공급자의 계층 구조에서 연결된 하위 사이트 맵 공급자를 제거합니다.Removes a linked child site map provider from the hierarchy for the current provider.

ResolveSiteMapNode(HttpContext) ResolveSiteMapNode(HttpContext) ResolveSiteMapNode(HttpContext) ResolveSiteMapNode(HttpContext)

SiteMapResolve 이벤트를 발생시킵니다.Raises the SiteMapResolve event.

(Inherited from SiteMapProvider)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

이벤트

SiteMapResolve SiteMapResolve SiteMapResolve SiteMapResolve

CurrentNode 속성이 호출될 때 발생합니다.Occurs when the CurrentNode property is called.

(Inherited from SiteMapProvider)

적용 대상

추가 정보