Elemento add aplicado a properties para profile (Esquema de configuración de ASP.NET)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
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 próximas secciones 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 Understanding ASP.NET Profile Properties. |
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 ASP.NET Profile Providers. |
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:
|
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 a los valores de configuración del elemento profile en el código de una aplicación, o sobre cómo modificarlos, 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á descriptores de acceso fuertemente tipados 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 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>
Información de elemento
Controlador de la sección de configuración |
|
Miembro de configuración |
|
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
Tareas
How to: Lock ASP.NET Configuration Settings
Referencia
Elemento properties para profile (Esquema de configuración de ASP.NET)
Elemento profile (Esquema de configuración de ASP.NET)
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento clear aplicado a properties para profile (Esquema de configuración de ASP.NET)
Elemento group aplicado a properties para profile (Esquema de configuración de ASP.NET)
Elemento remove aplicado a properties para profile (Esquema de configuración de ASP.NET)
Conceptos
ASP.NET Profile Properties Overview
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Otros recursos
Opciones de configuración de ASP.NET