siteMap の providers の add 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
ナビゲーション プロバイダーのコレクションにプロバイダーを追加します。
この要素は、.NET Framework Version 2.0 で追加されました。
<add
name="provider name"
type="provider type"
description="description"
siteMapFile="path"
/>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
description |
必須の String 属性です。 サイト マップ プロバイダーを記述します。 |
name |
必須の String 属性です。 追加するプロバイダーの名前を指定します。 |
siteMapFile |
省略可能な String 属性です。 サイト マップ データを含むファイルを指定します。 siteMapFile 参照としては次のいずれかを使用できます。
|
type |
必須の String 属性です。 ProviderBase クラスを実装する型を指定します。 type 値は、完全修飾アセンブリ参照である必要があります。 |
securityTrimmingEnabled |
既定値は false です。 この値が true で、プロバイダーに必要なロジックが含まれている場合、サイト マップ プロバイダーは取得したノードに対してロール チェックを実行します。 また、現在のユーザーに対してもロール チェックを実行します。 アプリケーションの URL 承認規則が適用され、Microsoft Windows 認証が使用されている場合は、アプリケーションのファイル承認規則も適用されます。 |
子要素
なし。
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
siteMap |
サイト ナビゲーションの構成、格納、およびレンダリングのためのナビゲーション インフラストラクチャをサポートする構成設定を定義します。 |
providers |
ナビゲーション プロバイダーのコレクションを定義します。 |
解説
既定の構成
次の既定の add 要素は、.NET Framework Version 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>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
要件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 2.0 Microsoft Visual Studio 2005 |
参照
処理手順
How to: Lock ASP.NET Configuration Settings
Reference
siteMap の providers 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
siteMap の providers の clear 要素 (ASP.NET 設定スキーマ)
siteMap の providers の remove 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities