Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Especifica el nombre del proveedor y la clase que lo implementa.
<add name="String"
type="String"
connectionStringName="String"
applicationName="String"
commandTimeout="number"/>
Atributos y elementos
En las secciones siguientes se describen los atributos, los elementos secundarios y los 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 |
El atributo String es obligatorio. Especifica una referencia calificada con el nombre 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 calificada con el nombre de ensamblado a una clase que implementa la clase base PersonalizationProvider. |
Elementos secundarios
Ninguno.
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Es el elemento raíz necesario en cada archivo de configuración que se utiliza en Common Language Runtime y las aplicaciones de .NET Framework. |
system.web |
Especifica el elemento raíz de las opciones de configuración 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 se agrega 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 los niveles de equipos, sitios y aplicaciones.
Información de elemento
Controlador de secciones de configuración |
|
Miembro de la configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones |
Requisitos |
IIS 5.0, 5.1 y 6.0 .NET Framework 2.0 Visual Studio 2005 |
Vea también
Tareas
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET
Referencia
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
Conceptos
Información general sobre la configuración de ASP.NET
Escenarios de configuración de ASP.NET
Proteger la configuración de ASP.NET
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET