Elemento add aplicado a providers para profile (Esquema de configuración de ASP.NET)
Agrega una instancia de proveedor de perfiles a la colección de proveedores de perfiles de usuario.
Se trata de un elemento nuevo en .NET Framework versión 2.0.
<add
name="provider name"
type="fully qualified type reference"
connectionStringName="connection string identifier"
commandTimeout="number of seconds before a command times out"
description="description of the provider instance"
applicationName="application name for stored profile information" />
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 instancia de proveedor. Éste es el valor utilizado para el atributo defaultProvider del elemento <profile> para identificar la instancia como proveedor de perfiles predeterminado. El name del proveedor también se utiliza para indizar el proveedor en la colección Providers. |
type |
Atributo String necesario. Especifica el tipo que implementa la clase base abstracta ProfileProvider. |
connectionStringName |
Atributo String necesario. Especifica el nombre de una cadena de conexión que se define en el elemento <connectionStrings>. El proveedor que se agregue utilizará la cadena de conexión especificada. |
applicationName |
Atributo String opcional. Especifica el nombre de la aplicación con la que se almacenan los datos de perfil en el origen de datos. El nombre de la aplicación permite que varias aplicaciones de ASP.NET utilicen la misma base de datos sin encontrar datos de perfil duplicados para aplicaciones diferentes. Un método alternativo es que varias aplicaciones de ASP.NET utilicen la misma información de perfiles especificando el mismo nombre de aplicación. Los proveedores de perfiles incluidos en .NET Framework usan el valor de ApplicationVirtualPath para la propiedad ApplicationName si no se especifica este atributo. |
commandTimeout |
Atributo Int32 opcional. Especifica el número de segundos que deben transcurrir antes de que se agote el tiempo de espera de un comando emitido en el origen de datos de pertenencia. El proveedor de SQL utiliza este tiempo de espera al crear objetos SqlCommand. Este atributo no se establece de forma predeterminada en la configuración de ASP.NET. Por consiguiente, se utiliza el valor predeterminado de ADO.NET, que son 30 segundos. Si se establece este atributo, el proveedor de SQL utiliza el valor de tiempo de espera configurado para todos los comandos de SQL emitidos en la base de datos. El valor predeterminado es 30 (valor predeterminado de ADO.NET). |
description |
Atributo String opcional. Especifica una descripción de la instancia del proveedor de perfiles. |
Elementos secundarios
Ninguno.
Elementos primarios
Elemento |
Descripción |
|---|---|
providers |
Define una colección de proveedores de perfiles para el perfil de usuario. |
profile |
Configura el perfil de usuario para una aplicació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. |
Comentarios
Se pueden incluir atributos adicionales en el elemento add de una implementación de proveedores de perfiles personalizada. Para obtener un ejemplo, vea Cómo: Generar y ejecutar el ejemplo de proveedor de perfiles.
Para obtener información sobre cómo tener acceso a los valores de configuración del elemento profile en el código de aplicación y cómo modificarlos, vea ProfileSection.
Configuración predeterminada
En .NET Framework 2.0, el siguiente elemento profile predeterminado se configura en el archivo Machine.config.
<providers>
<add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
Ejemplo
En el ejemplo de código siguiente se muestra cómo crear un archivo Web.config para una aplicación ASP.NET configurada para utilizar un proveedor SqlProfileProvider.
<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"
applicationName="SampleApplication"
enablePasswordRetrieval="true"
enablePasswordReset="true"
passwordFormat="Encrypted"
requiresQuestionAndAnswer="true" />
</providers>
</membership>
<profile defaultProvider="SqlProvider">
<providers>
<clear />
<add name="SqlProvider"
type="System.Web.Profile.SqlProfileProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication"
description="SqlProfileProvider for SampleApplication" />
</providers>
<properties>
<add name="ZipCode" />
<add name="CityAndState" />
</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
Cómo: Bloquear los valores de configuración de ASP.NET
Referencia
Elemento profile (Esquema de configuración de ASP.NET)
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento remove aplicado a providers para profile (Esquema de configuración de ASP.NET)
Elemento clear aplicado a providers para profile (Esquema de configuración de ASP.NET)
Conceptos
Información general sobre las propiedades de perfil de ASP.NET
Información general sobre la configuración de ASP.NET
Controles de servidor web ASP.NET y funciones del explorador
Proteger la configuración de ASP.NET
Escenarios de configuración de ASP.NET
Otros recursos
Archivos de configuración de ASP.NET
Opciones de configuración de ASP.NET