Section 項目繼承的一般屬性

發行項
05/28/2012

ASP.NET 以階層式方式將組態設定套用至資源。組態設定繼承自父組態檔。本主題列出由所有 Section 項目所繼承的數個一般屬性。

Section 項目

Section 項目是組態區段的成員。這不包括隸屬於組態區段群組的項目。

組態區段宣告顯示在組態檔頂端的 configSections 項目內。 section 項目中包含的每個宣告都指定區段名稱和 .NET Framework 類別 (衍生自 ConfigurationSection) 名稱，這個類別處理該區段中的組態資料。 section 標記可以在 sectionGroup 標記中分組。

如需詳細資訊，請參閱 ASP.NET Configuration Files 或 Format of ASP.NET Configuration Files。

一般屬性

下表描述可為任何區段項目設定的一般屬性。這些一般屬性也會由 Section 項目的子項目所繼承。名稱中包含 lock 一字的所有屬性，其設計都是為了要保護組態檔中指定的內容避免遭到變更。根據預設，不會鎖定任何項目或屬性。

屬性	描述
configSource	選擇性 String 屬性。指定 Inlcude 檔的名稱，該檔案中會定義相關聯的組態區段 (如果檔案存在的話)。可透過 ConfigSource 屬性以程式的方式存取。在使用 configSource 屬性時，由於不能合併項目設定，您必須將整個區段都移至個別檔案。根據預設，對於外部檔案的任何變更，都會使應用程式重新啟動。若要變更這項行為，以便讓應用程式不會在每次變更後重新啟動，您可以在 Web.config 檔中設定 configSections 的 section 項目 (一般設定結構描述)，並將其 restartOnExternalChanges 屬性設定為 false。
lockAllAttributesExcept	選擇性 String 屬性，值可以是逗號分隔的清單。鎖定父項目的所有屬性 (指定的屬性除外)。可透過 LockAllAttributesExcept 屬性以程式的方式存取。組態階層架構的較低層級，絕對無法鎖定在階層架構中高於它們的層級。
lockAllElementsExcept	選擇性 String 屬性，值可以是逗號分隔的清單。鎖定父項目的所有子項目 (指定的項目除外)。可透過 LockAllElementsExcept 屬性以程式的方式存取。
lockAttributes	選擇性 String 屬性，值可以是逗號分隔的清單。鎖定父項目的所有屬性。可透過 LockAttributes 屬性以程式的方式存取。
lockElements	選擇性 String 屬性，值可以是逗號分隔的清單。鎖定父項目的所有子項目。可透過 LockElements 屬性以程式的方式存取。
lockItem	選擇性 String 屬性。如果應該鎖定屬性位於其上的項目，則為 true，否則為 false。預設值為 false。這個屬性除了能夠用來鎖定任何個別項目以外，也能用於集合項目，以便特地鎖定指定之集合內的項目。而且，此屬性也能用來鎖定任意的整個區段。可透過 LockItem 屬性以程式的方式存取。

範例

下列程式碼範例是 Machine.config 檔案的一部分。其中組態區段處理常式的宣告是針對 system.web 區段群組和 anonymousIdentification 區段而進行。再下來宣告 system.Web 和 anonymousIdentification 組態項目。

system.Web 組態項目是組態區段群組的成員，這表示它不包含任何屬性。

anonymousIdentification 組態項目組態區段的成員，因此它會繼承之前表格所列出的屬性。請注意，其 configSource 屬性具有指派給它的外部檔案 (以包含項目的內容)，而且 lockItem 屬性設定為 true，以防止變更其內容。

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

請參閱

共用方式為

Section 項目繼承的一般屬性

Section 項目

一般屬性

範例

請參閱

工作

概念

其他資源

其他資源