設定檔的 properties 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

定義使用者設定檔屬性和屬性群組的集合。

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

<properties>
    <add... />
    <clear />
    <remove... />
    <group>...</group>
</properties>

屬性和項目

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

屬性

無。

子項目

項目	描述
add	選擇性項目。將屬性加入使用者設定檔。
clear	選擇性項目。清除使用者設定檔中所有先前定義的屬性。
group	選擇性項目。定義使用者設定檔屬性的群組。
remove	選擇性項目。移除使用者設定檔的屬性。

父項目

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

備註

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

範例

下列範例 Web.config 檔會指定使用者設定檔，該設定檔包含字串型別的 ZipCode 屬性和 StringCollection 型別的 RecentSearchList 屬性。產生的 Profile 將具有每個指定屬性的強型別存取子。如需使用者設定檔的詳細資訊，以及設定和讀取使用者設定檔屬性的範例，請參閱 ASP.NET Profile Properties Overview。

<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>
       <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 2005

請參閱

共用方式為

設定檔的 properties 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源