location 要素 (ASP.NET 設定スキーマ)

  • [アーティクル]

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

子構成設定が適用されるリソースを指定して構成設定をロックすることで、設定が子構成ファイルによりオーバーライドされないようにします。

この要素は、.NET Framework Version 2.0 で追加されました。

<location 
   allowOverride="true|false"
   path="path" 
/>

属性および要素

以降のセクションでは、この要素の属性、子要素、および親要素について説明します。

属性

属性

Description

allowOverride

省略可能な Boolean 型の属性です。

子ディレクトリの Web.config ファイル内の構成設定により構成設定をオーバーライドするかどうかを指定します。

既定値は true. です。

path

省略可能な String 型の属性です。

含まれている構成設定を適用するリソースを指定します。 指定先が存在しない path 属性と共に location を使用すると、構成設定は、現在のディレクトリとそのすべての子ディレクトリに適用されます。 location と共に path 属性を使用せず、allowOverride が false の場合、子ディレクトリの Web.config ファイルによって構成設定を変更することはできません。

inheritInChildApplications

省略可能な Boolean 型の属性です。

Web サイトのルート ディレクトリなどの特定の位置に固有の構成設定が、サブディレクトリに存在するアプリケーションに継承されるかどうかを指定します。

既定値は true. です。

子要素

location 要素は、他の要素を囲んで、構成設定を特定のリソースに適用したり、構成設定をロックしたりできます。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。

解説

location 要素は、子構成設定が適用されるリソースを指定し、また構成設定のロックに使用することで、設定が子構成ファイルによりオーバーライドされないようにします。

location 要素は、他の要素を囲んで、構成設定を特定のリソースに適用したり、設定をロックしたりできます。 詳細については、「Configuration <location> Settings」および「Locking Configuration Settings」を参照してください。

使用例

Logon.aspx ページへのアクセスを匿名ユーザーに許可する方法を次のコード例に示します。

<configuration>
   <location path="Logon.aspx">
      <system.web>
         <authorization>
            <allow users="?"/>
         </authorization>
      </system.web>
   </location>
</configuration>

指定されたページだけアップロード ファイルの制限を 128 KB に設定する方法を次のコード例に示します。

<configuration>
  <location path="UploadPage.aspx">
    <system.web>
      <httpRuntime maxRequestLength="128"/>
    </system.web>
  </location>
</configuration>

子ディレクトリの Web.config ファイルによって構成設定が変更されるのを防ぐ方法を次のコード例に示します。

<configuration>
   <location allowOverride="false"/>
</configuration>

要素情報

構成セクション ハンドラー

該当なし

構成メンバー

ConfigurationLocation

構成できる場所

Machine.config

ルート レベルの Web.config

アプリケーション レベルの Web.config

仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config

要件

Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 2.0

Microsoft Visual Studio 2003 または Visual Studio 2005

参照

処理手順

How to: Lock ASP.NET Configuration Settings

How to: Configure Specific Folders Using Location Settings

Reference

configuration 要素 (全般設定スキーマ)

ConfigurationLocation

概念

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

その他の技術情報

ASP.NET 構成設定