共用方式為

NameValueSectionHandler 和 DictionarySectionHandler 的 <clear> 項目

  • 發行項

清除區段中所有先前定義的設定。

<configuration>
<section name>
<clear>

<clear/>

備註

您可以使用 <clear> 項目來從您的應用程式中移除所有已在組態檔階層架構較高層級中定義的設定。

範例

下列範例顯示如何在應用程式組態檔中使用 <clear> 項目，以清除先前定義在電腦組態檔中的區段。

下列電腦組態檔程式碼宣告區段 <mySection>。

<!-- Machine.config file.-->
<configuration>
   <configSections>
      <section name="mySection"
         type="System.Configuration.NameValueSectionHandler,System" />
   </sectionGroup>
   </configSections>
   <mySection>
      <add key="key1" value="value1" />
      <add key="key2" value="value2" />
   </mySection>
</configuration>

下列應用程式組態檔程式碼會將 <mySection> 中的所有設定移除。應用程式無法擷取任何一個已在電腦組態檔的 <mySection> 區段中宣告的設定。

<!-- Application configuration file. -->
<configuration>
   <mySection>
      <clear/>
   </mySection>
</configuration>

組態檔

這個項目可以在不是位於應用程式目錄層級的應用程式組態檔、電腦組態檔 (Machine.config) 和 Web.config 檔案中使用。

請參閱

組態區段結構描述 | 組態區段設定