Elemento add aplicado a properties para profile (Esquema de configuración de ASP.NET)

Artículo
08/10/2011

Agrega una propiedad al perfil de usuario.

Se trata de un elemento nuevo en .NET Framework, versión 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" />
/>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
name	El atributo String es obligatorio. Especifica el nombre de la propiedad. Este valor se utiliza como el nombre de la propiedad de la clase de perfil generada automáticamente y como el valor de índice de la propiedad de la colección Properties. El nombre de la propiedad no puede contener un punto (.). Para obtener más información sobre la generación automática de las propiedades de perfil de usuario, vea Información general sobre las propiedades de perfil de ASP.NET.
type	Atributo String opcional. Especifica el tipo de la propiedad. El valor predeterminado es String.
provider	Atributo String opcional. Especifica el proveedor de perfiles que se utiliza para almacenar y recuperar los valores de la propiedad. El valor del atributo provider es el nombre de uno de los proveedores de perfiles especificados en el elemento providers. Si no se especifica ningún nombre de proveedor, se utiliza el proveedor predeterminado especificado en el elemento profile. Para obtener más información sobre los proveedores de perfiles, vea Proveedores de perfiles de ASP.NET.
serializeAs	Atributo SettingsSerializeAs opcional. Especifica el formato de serialización del valor de propiedad en el almacén de datos. El formato de serialización predeterminado es específico del proveedor. La serialización que se utiliza realmente viene determinada por el proveedor, que es la serialización String en el caso del proveedor SQL.
allowAnonymous	Atributo Boolean opcional. Especifica si la propiedad se puede obtener o establecer en el caso de que el usuario de la aplicación sea anónimo. Si su valor es true, la propiedad se puede obtener o establecer en el caso de que el usuario de la aplicación sea anónimo. El valor predeterminado es false.
defaultValue	Atributo String opcional. Especifica el valor predeterminado si no hay ningún valor para la propiedad Profile en el almacén de datos: Si el tipo de la propiedad se serializa utilizando la serialización XML, este atributo puede establecerse en una cadena XML que representa una instancia serializada del tipo de propiedad. Si el tipo de la propiedad se serializa utilizando la serialización binaria, este atributo puede establecerse en una cadena codificada en base 64 que representa una instancia serializada del tipo de propiedad. Si la propiedad es un tipo de referencia, se puede utilizar el valor String null para indicar que la propiedad Profile debe devolver null para los perfiles no inicializados.
readOnly	Atributo Boolean opcional. Especifica si la propiedad se puede leer pero no establecer. Si su valor es true, se puede leer pero no establecer la propiedad. El valor predeterminado es false.
customProviderData	Atributo String opcional. Especifica que el atributo customProviderData se puede establecer en cualquier valor de cadena que vaya a utilizar el proveedor de perfiles de la propiedad. Si se establece el valor de este atributo, el valor se coloca en la colección Attributes de la propiedad y se indiza por el nombre "CustomProviderData".

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de la sección de configuración de ASP.NET.
profile	Configura el perfil de usuario para una aplicación.
properties	Define una colección de propiedades de perfiles de usuario y de grupos de propiedades.

Comentarios

Para obtener información sobre cómo obtener acceso y modificar los valores de configuración del elemento profile en el código de una aplicación, vea ProfileSection.

Ejemplo

En el siguiente archivo Web.config se muestra cómo especificar un perfil de usuario que contiene la propiedad ZipCode de la cadena de tipo y la propiedad RecentSearchList de StringCollection. La propiedad Profile generada tendrá los descriptores de acceso con establecimiento inflexible de tipos para cada una de las propiedades especificadas. Para obtener información sobre el perfil de usuario y obtener un ejemplo en el que se establecen y se leen las propiedades de los perfiles de usuario, vea Información general sobre las propiedades de perfil de ASP.NET.

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

Información de elemento

Controlador de la sección de configuración	System.Web.Configuration.ProfileSection
Miembro de configuración	SystemWebSectionGroup.Profile
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones
Requisitos	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 2.0 Microsoft Visual Studio 2005

Vea también

Elemento add aplicado a properties para profile (Esquema de configuración de ASP.NET)

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales