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

發行項
05/28/2012

將屬性加入使用者設定檔。

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

<add 
    name="property name" 
    type="fully qualified type reference"
    provider="provider name"
    serializeAs="String|Xml|Binary|ProviderSpecific"
    allowAnonymous="true|false"
    defaultValue="default property value"
    readOnly="true|false"
    customProviderData="data for a custom profile provider" />
/>

屬性和項目

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

屬性

屬性	描述
name	必要的 String 屬性。指定屬性的名稱。這個值用做自動產生之設定檔類別的屬性名稱，並用做 Properties 集合中屬性的索引值。屬性名稱不能包含句號 (.)。如需自動產生使用者設定檔屬性的詳細資訊，請參閱 Understanding ASP.NET Profile Properties。
type	選擇性 String 屬性。指定屬性的型別。預設值為 String。
provider	選擇性 String 屬性。指定用於儲存和擷取屬性值的設定檔提供者。 provider 屬性的值是 providers 項目中指定的其中一個設定檔提供者名稱。如果未指定提供者名稱，則會使用 profile 項目中指定的預設提供者。如需設定檔提供者的詳細資訊，請參閱 ASP.NET Profile Providers。
serializeAs	選擇性 SettingsSerializeAs 屬性。指定資料存放區中屬性值的序列化格式。預設序列化格式會因提供者而不同。實際使用的序列化由提供者決定，如果是 SQL 提供者則為 String 序列化。
allowAnonymous	選擇性 Boolean 屬性。指定如果應用程式使用者為匿名時，是否可以取得或設定屬性。如果設定為 true，則應用程式使用者為匿名時可以取得或設定屬性。預設值為 false。
defaultValue	選擇性 String 屬性。指定資料存放區中 Profile 屬性不具有值時的預設值，如下列所示：如果使用 XML 序列化對屬性型別進行序列化，則這個屬性可設為表示屬性型別之序列化執行個體的 XML 字串。如果使用二進位序列化對屬性型別進行序列化，則這個屬性可設為表示屬性型別之序列化執行個體的 Base-64 編碼字串。如果屬性是參考型別，則可以使用 String null 值表示 Profile 屬性應該對未初始化的設定檔傳回 null。
readOnly	選擇性 Boolean 屬性。指定是否可讀取屬性，但是不能設定屬性。如果設定為 true，則可以讀取屬性但是不能設定屬性。預設值為 false。
customProviderData	選擇性 String 屬性。指定 customProviderData 屬性可以設為任何字串值，以供屬性的設定檔提供者使用。如果設定這個屬性，則會將值置於屬性的 Attributes 集合，並依名稱 "CustomProviderData" 對值進行索引。

子項目

無。

父項目

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

備註

如需存取和修改應用程式程式碼中 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

請參閱

共用方式為

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

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源