共用方式為


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

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

這個項目是 .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 設定檔屬性概觀

<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

請參閱

工作

HOW TO:鎖定 ASP.NET 組態設定

參考

profile 項目 (ASP.NET 設定結構描述)

system.web 項目 (ASP.NET 設定結構描述)

<configuration> 項目

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

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

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

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

ProfileSection

System.Configuration

System.Web.Configuration

概念

ASP.NET 設定檔屬性概觀

ASP.NET 組態概觀

ASP.NET Web 伺服器控制項和瀏覽器能力

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

ASP.NET 組態檔

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET 組態 API