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

發行項
05/28/2012

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

<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 屬性。指定用於儲存和擷取屬性值的設定檔提供者。這個屬性的值是 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	定義使用者設定檔屬性和屬性群組的集合。
group	定義使用者設定檔屬性的群組。

備註

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

範例

下列範例 Web.config 檔將示範如何指定包含屬性群組的使用者設定檔，且該屬性群組的群組名稱為 Address。群組名稱 (例如 Profile.Address.Street) 位於 Profile 屬性所產生之群組屬性之前。如需使用者設定檔的詳細資訊，以及設定和讀取使用者設定檔屬性群組的範例，請參閱 ASP.NET Profile Properties Overview。

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

  <system.web>
      <authentication mode="Forms" >
        <forms loginUrl="login.aspx"
             name=".ASPXFORMSAUTH" />
      </authentication>

       <authorization>
          <deny users="?" />
       </authorization>

      <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
        <providers>
          <clear />
          <add 
            name="SqlProvider" 
            type="System.Web.Security.SqlMembershipProvider" 
            connectionStringName="SqlServices"
            enablePasswordRetrieval="false"
            enablePasswordReset="true"
            requiresQuestionAndAnswer="true" 
            requiresUniqueEmail="false"
            passwordFormat="Hashed"
            applicationName="MyApplication" />
        </providers>
      </membership>

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

        <properties>
          <add name="ZipCode" />
          <group name="Address">
             <add name="Street" />
             <add name="City" />
             <add name="State" />
             <add name="CountryOrRegion" />
          </group>
        </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 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源