Elemento add que se aplica a los proveedores de elementos Web (Esquema de configuración de ASP.NET)

Artículo
09/05/2008

Actualización: noviembre 2007

Especifica el nombre del proveedor y la clase que lo implementa.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    webParts (Elemento, Esquema de configuración de ASP.NET)
      Elemento personalization para elementos Web (Esquema de configuración de ASP.NET)
        Elemento providers para la personalización de elementos Web (Esquema de configuración de ASP.NET)
          Elemento add que se aplica a los proveedores de elementos Web (Esquema de configuración de ASP.NET)

<add name="String" 
     type="String" 
     connectionStringName="String" 
     applicationName="String" 
     commandTimeout="number"/>

Atributos y elementos

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

Atributos

Atributo	Descripción
applicationName	Atributo String opcional. Especifica el nombre de la aplicación para la que se va a almacenar y recuperar información de personalización.
connectionStringName	Atributo String necesario. Especifica la cadena específica del proveedor de SQL que se utiliza para conectar a la base de datos.
commandTimeout	Atributo Int32 opcional. Especifica los segundos que deben transcurrir antes de que se agote el tiempo de espera de un comando emitido al origen de datos de personalización de elementos Web. 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. Como resultado se utiliza el valor predeterminado de ADO.NET de 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 a la base de datos.
name	Atributo String necesario. Nombre descriptivo del proveedor.
type	Atributo String necesario. Especifica una referencia completa de ensamblado a una clase que implementa la clase base PersonalizationProvider. Dependiendo de la ubicación del código que contiene el proveedor, puede ser una referencia parcial (por ejemplo, sólo EspacioDeNombres.NombreDeClase o EspacioDeNombres.NombreDeClase, NombreDeEnsamblado) o una referencia de ensamblado completa a una clase que implementa la clase base PersonalizationProvider.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de las opciones de ASP.NET en un archivo de configuración. Contiene los elementos de configuración que configuran las aplicaciones Web ASP.NET y determinan su funcionamiento.
webParts	Permite especificar un proveedor de personalización de elementos Web, establecer autorizaciones de personalización y agregar clases personalizadas que amplían la clase WebPartTransformer para que las conexiones de elementos Web puedan utilizarla.
personalization	Especifica el proveedor de personalización de elementos Web y establece autorizaciones de personalización de elementos Web.
providers	Define los proveedores de personalización de los elementos Web para la aplicación Web actual.

Comentarios

Es importante tener en cuenta que la personalización producirá errores si la aplicación Web no se ejecuta en el nivel de confianza predeterminado Medio o superior (se pueden establecer niveles de confianza personalizados en un archivo Web.config con el elemento <trust level="" />). Las clases PersonalizationAdministration y SqlPersonalizationProvider comprueban si el nivel de confianza es Low cuando se inicializan. Si la aplicación se configura para ejecutarla en un nivel de confianza Low y se utiliza el proveedor SqlPersonalizationProvider personalizado para administrar los datos de personalización de la aplicación, la primera vez que ésta intenta tener acceso a los datos de personalización, se producirá un error porque un proceso de trabajo de ASP.NET que se ejecuta en el nivel de confianza Bajo no tiene los permisos necesarios para llamar a las distintas clases del espacio de nombres System.Data.SqlClient.

Configuración predeterminada

El siguiente elemento add predeterminado está configurado en el archivo Web.config raíz en la versión 2.0 de .NET Framework.

<providers>
  <add name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
    connectionStringName="LocalSqlServer"
  />
</providers>

Ejemplo

En el siguiente ejemplo se muestra cómo agregar un proveedor.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
      type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" 
        applicationName="/" />
    </providers>
  </personalization>
</webParts>

Los proveedores sólo se pueden definir en el nivel de equipo, sitio y aplicación.

Información de elemento

Controlador de la sección de configuración	System.Web.Configuration.WebPartsSection
Miembro de la configuración	WebPartsPersonalization.Providers
Ubicaciones configurables	Machine.config Web.config del nivel de raíz Web.config del nivel de aplicación
Requisitos	IIS 5.0, 5.1 y 6.0 .NET Framework 2.0 Visual Studio 2005

Vea también

Compartir a través de

Elemento add que se aplica a los proveedores de elementos Web (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

Conceptos

Referencia

Otros recursos

Recursos adicionales