siteMap의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

탐색 공급자의 컬렉션에 공급자를 추가합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<add  
   name="provider name" 
   type="provider type"
   description="description"
   siteMapFile="path"
/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
description	필수 String 특성입니다. 사이트 맵 공급자에 대해 설명합니다.
name	필수 String 특성입니다. 추가할 공급자의 이름을 지정합니다.
siteMapFile	선택적 String 특성입니다. 사이트 맵 데이터가 포함된 파일을 지정합니다. siteMapFile 참조는 다음 중 하나일 수 있습니다. 응용 프로그램에 상대적인 경로 참조(예: ~/SiteMapFile1.sitemap) 응용 프로그램에 대한 디렉터리 구조 내의 위치에 매핑되는 가상 경로(예: /directory1/directory2/SiteMapFile1.sitemap) 응용 프로그램에 대한 디렉터리 구조의 루트에 상대적인 경로 참조(예: SiteMapFile1.sitemap)
type	필수 String 특성입니다. ProviderBase 클래스를 구현하는 형식을 지정합니다. type 값은 정규화된 어셈블리 참조여야 합니다.
securityTrimmingEnabled	기본값으로 false가 지정됩니다. 이 값이 true인 경우, 필요한 논리가 공급자에 포함되어 있으면 사이트 맵 공급자는 검색된 노드에 대해 역할 검사를 수행합니다. 또한 공급자는 현재 사용자에 대해서도 역할 검사를 수행합니다. 응용 프로그램에 대한 URL 권한 부여 규칙이 적용되고 Microsoft Windows 인증이 사용되는 경우에는 응용 프로그램에 대한 파일 권한 부여 규칙도 적용됩니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 제공합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.
siteMap	사이트 탐색의 구성, 저장 및 렌더링에 필요한 탐색 인프라를 지원하는 구성 설정을 정의합니다.
providers	탐색 공급자의 컬렉션을 정의합니다.

설명

기본 구성

다음의 기본 add 요소는 .NET Framework 버전 2.0의 루트 Web.config 파일에 구성되어 있습니다.

<add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
     type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral, 
     PublicKeyToken=b03f5f7f11d50a3a" />

예제

다음 코드 예제에서는 Web.config 파일에 사이트 맵 공급자를 추가하여 ASP.NET에 대해 정의된 기본 사이트 맵 공급자를 재정의하는 방법을 보여 줍니다.

<configuration>
  <system.web>
    <siteMap>
      <providers>
        <add 
          name="XmlSiteMapReader"
          type="XmlSiteMapProvider, System.Web, Version=1.1.3300.0,
                Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
          siteMapFile="my.sitemap"
          description="XmlSiteMapProvider that loads my.sitemap"/>
      </providers>
      <siteMap>
  </system.web>
</configuration>

요소 정보

구성 섹션 처리기	System.Web.Configuration.SiteMapSection
구성 멤버	SiteMapSection.Providers
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2005

참고 항목

다음을 통해 공유