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


<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" /> />

<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 集合中的索引值。该属性的名称不能包含句点 (.)。有关自动生成用户配置文件属性的更多信息，请参见 ASP.NET 配置文件属性概述。
type	可选的 String 属性。指定属性类型。默认值为 String。
provider	可选的 String 属性。指定用于存储和检索属性值的配置文件提供程序。此属性的值是 providers 元素中指定的某个配置文件提供程序的名称。如果未指定提供程序名称，则使用 profile 元素中指定的默认提供程序。有关配置文件提供程序的更多信息，请参见 ASP.NET 配置文件提供程序。
serializeAs	可选的 SettingsSerializeAs 属性。指定数据存储区中属性值的序列化格式。默认序列化格式视具体的提供程序而定。实际所使用的序列化由提供程序确定；对于 SQL 提供程序，则为 String 序列化。
allowAnonymous	可选的 Boolean 属性。指定在应用程序用户是匿名用户的情况下是否可以获取或设置属性。如果设置为 true，则在应用程序用户是匿名用户的情况下可以获取或设置属性。默认值为 false。
defaultValue	可选的 String 属性。指定当数据存储区中的 Profile 属性没有值时所使用的默认值。如果使用 XML 序列化对属性 (Property) 类型进行了序列化处理，则此属性 (Attribute) 可以设置为表示属性 (Property) 类型的序列化实例的 XML 字符串。如果使用二进制序列化对属性 (Property) 类型进行了序列化处理，则此属性 (Attribute) 可以设置为表示属性 (Property) 类型的序列化实例的 Base-64 编码字符串。如果属性为引用类型，则可以使用 stringnull 指示 Profile 属性应为未初始化的配置文件返回 null。
readOnly	可选的 Boolean 属性。指定是否只能读取而不能设置属性。如果设置为 true，则可以读取但不可以设置属性。默认值为 false。
customProviderData	可选的 String 属性。指定供属性的配置文件提供程序使用的字符串值。此属性可以设置为任何字符串值。如果设置了 customProviderData 属性 (Attribute)，则该值放置在属性 (Property) 的 Attributes 集合中，通过名称 "CustomProviderData" 进行索引。

子元素

无。

父元素

元素	说明
configuration	指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.web	为 ASP.NET 配置节指定根元素。
profile	为应用程序配置用户配置文件。
properties	定义用户配置文件属性和属性组的集合。
group	定义用户配置文件属性的分组。

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

下面的 Web.config 文件示例演示如何指定一个用户配置文件，此配置文件包含组名为 Address 的属性组。为 Profile 属性生成的分组属性将以组名开头（如 Profile.Address.Street）。若要查看有关用户配置文件的信息以及设置和读取用户配置文件属性组的示例，请参见 ASP.NET 配置文件属性。

?	复制代码
<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>

?

复制代码

<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
配置成员	System.Web.Configuration.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

任务

如何：锁定 ASP.NET 配置设置

参考

profile 的 properties 的 group 元素（ASP.NET 设置架构）
profile 元素（ASP.NET 设置架构）
system.web 元素（ASP.NET 设置架构）
<configuration> 元素
profile 的 group 的 remove 元素（ASP.NET 设置架构）
ProfileSection
System.Configuration
System.Web.Configuration

概念

ASP.NET 配置概述
ASP.NET Web 服务器控件和浏览器功能
保证 ASP.NET 配置的安全
ASP.NET 配置方案

其他资源

ASP.NET 配置文件属性
ASP.NET 配置文件
ASP.NET 配置设置
常规配置设置 (ASP.NET)
ASP.NET 配置 API

属性和元素

属性

子元素

父元素

备注

示例

元素信息

请参见

任务

参考

概念

其他资源