webParts (Elemento, Esquema de configuración de ASP.NET)

  • Artículo

Permite especificar un proveedor de personalización de elementos Web, establecer autorizaciones de personalización y agregar clases personalizadas que amplíen la clase WebPartTransformer para que la puedan utilizar las conexiones de elementos Web.

<webParts enableExport="true|false">
   <personalization...>...</personalization>
   <transformers>...</transformers >
</webParts>

Atributos y elementos

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

Atributos

Atributo

Descripción

enableExport

Atributo Boolean opcional.

Habilita la exportación de datos de control a un archivo de descripción XML.

El valor predeterminado es false.

Elementos secundarios

Elemento

Descripción

personalization

Elemento opcional.

Especifica el proveedor de personalización de elementos web y establece las autorizaciones de personalización de elementos web.

transformers

Elemento opcional.

Define una colección de objetos TransformerInfo.

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.

Comentarios

Configuración predeterminada

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

<webParts>
  <personalization>
    <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>

    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>

  </personalization>

  <transformers>
    <add name="RowToFieldTransformer"
      type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
    <add name="RowToParametersTransformer" 
      type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
  </transformers>
</webParts>

Ejemplo

En el siguiente ejemplo se muestra cómo especificar valores de forma declarativa para la sección webParts.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
        type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" applicationName="/" />
    </providers>
    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>
  </personalization>
</webParts>

Los proveedores solo se pueden definir en el nivel de la aplicación.

Información de elemento

Controlador de secciones de configuración

System.Web.Configuration.WebPartsSection

Miembro de configuración

SystemWebSectionGroup.WebParts

Ubicaciones configurables

Machine.config

Web.config del nivel de raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos

Versión 6.0 de IIS

.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)

Elemento personalization para elementos Web (Esquema de configuración de ASP.NET)

Elemento transformers para los elementos Web (Esquema de configuración de ASP.NET)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

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

Administración de sitios web ASP.NET

API de configuración de ASP.NET