profile 的 group 的 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	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.web	为 ASP.NET 配置节指定根元素。
profile	为应用程序配置用户配置文件。
properties	定义用户配置文件属性和属性组的集合。
group	定义用户配置文件属性的分组。

备注

有关访问和修改应用程序代码中 profile 元素的配置值的信息，请参见 ProfileSection。

示例

下面的 Web.config 文件示例演示如何指定一个用户配置文件，此配置文件包含组名为 Address 的属性组。为 Profile 属性生成的分组属性将以组名开头（如 Profile.Address.Street）。若要查看有关用户配置文件的信息以及设置和读取用户配置文件属性组的示例，请参见 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 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2005

请参见

通过

profile 的 group 的 add 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源