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

Artículo
05/27/2012

[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 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 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 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	El atributo String es obligatorio. Especifica el tipo que implementa la clase base abstracta ProfileProvider.
connectionStringName	El atributo String es obligatorio. Especifica el nombre de una cadena de conexión definida 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. De manera predeterminada, este atributo no se establece 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 SQL utiliza el valor de tiempo de espera configurado para todos los comandos SQL emitidos a 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 Sample Profile Provider Implementation.

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.

Configuración predeterminada

En la versión 2.0 de .NET Framework, 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	System.Web.Configuration.ProfileSection
Miembro de la configuración	ProfileSection.Providers
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

Compartir a través de

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales