profile 的 properties 的 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	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
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 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2005

请参见

通过

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

特性和元素

特性

子元素

父元素

备注

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源