configSections 的 clear 項目 (一般設定結構描述)

發行項
05/28/2012

移除已繼承之區段和區段群組的所有參考，只允許由目前 section 和 sectionGroup 項目所加入的區段和區段群組。

<clear />

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

無。

子項目

無。

父項目

項目	描述
configuration	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。
configSections	指定組態區段和命名空間宣告。
sectionGroup	在組態區段處理常式和組態區段之間定義關聯。

備註

clear 項目會移除已繼承之區段和區段群組的所有參考，只允許由目前 section 和 sectionGroup 項目所加入的區段和區段群組。

如果組態檔嘗試在移除處理常式參考之後使用組態區段，則 ASP.NET 會發出伺服器錯誤「無法辨認的組態區段 element_name」。

範例

下列程式碼範例將顯示如何在應用程式組態檔中使用 clear 項目，清除先前在 Machine.config 檔中定義的區段。

下列 Machine.config 檔程式碼宣告兩個在應用程式組態檔之前讀取的區段：sampleSection 和 anotherSampleSection。

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
      <section name="anotherSampleSection"
               type="System.Configuration.NameValueSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

下列應用程式組態檔程式碼清除先前宣告的所有區段。應用程式不能使用或擷取在 Machine.config 檔中所宣告之兩個區段的設定。不過，應用程式可以使用 anotherSection 的設定，因為 anotherSection 位於 clear 項目之後。

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

項目資訊

組態區段處理常式	不套用。
組態成員	Clear() Clear()
可設定的位置	Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config
需求	Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 1.0、1.1 或 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

共用方式為

configSections 的 clear 項目 (一般設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

參考

概念

其他資源

其他資源