設定檔屬性的 clear 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

清除使用者設定檔中所有先前定義的屬性和群組。

這個項目是 .NET Framework 2.0 版中新增的項目。

<clear />

屬性和項目

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

屬性

無。

子項目

無。

父項目

項目	描述
configuration	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。
system.web	指定 ASP.NET 組態區段的根項目。
profile	設定應用程式的使用者設定檔。
properties	選擇性項目。定義使用者設定檔屬性和屬性群組的集合。

備註

如需存取和修改應用程式程式碼中 profile 項目組態值的詳細資訊，請參閱 ProfileSection。

範例

下列程式碼範例將示範如何使用 <clear> 項目，在加入新的設定檔屬性之前，清除任何現有的設定檔屬性定義。

<configuration>
   <connectionStrings>
       <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
            Catalog=aspnetdb;" />
   </connectionStrings>

  <system.web>
   <anonymousIdentification enabled="true" />

   <profile defaultProvider="SqlProvider" >
     <providers>
       <add
         name="SqlProvider"
         connectionStringName="SqlServices"
         applicationName="HttpProfileBaseApplication"
         type="System.Web.Profile.SqlProfileProvider" />
     </providers>

     <properties>
       <clear />
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </properties>
    </profile>
   </system.web>
</configuration>

項目資訊

組態區段處理常式	System.Web.Configuration.ProfileSection
組態成員	SystemWebSectionGroup.Profile
可設定的位置	Machine.config 根層次的 Web.config 應用程式層級的 Web.config
需求	Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

共用方式為

設定檔屬性的 clear 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源