Compartir a través de


Elemento providers para la personalización de elementos Web (Esquema de configuración de ASP.NET)

Actualización: noviembre 2007

Define los proveedores de personalización de los elementos Web para la aplicación Web actual.

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)

<providers>
    <add.../>
    <clear />
    <remove.../>
</providers>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

add

Elemento opcional

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

clear

Elemento opcional

Quita todos los proveedores de elementos Web de la colección.

remove

Elemento opcional

Quita el proveedor de elementos Web especificado de la colección.

Elementos primarios

Elemento

Descripción

configuration

Es el 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.

Comentarios

Configuración predeterminada

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

<providers>
  <add connectionStringName="LocalSqlServer"
    name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider, 
    System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</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 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 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

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

Referencia

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento configuration (Esquema de configuración general)

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

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

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

WebPartsSection

WebPartsPersonalization

System.Configuration

System.Web.Configuration

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

API de configuración de ASP.NET