Share via

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

  • Artículo

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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

<personalization defaultProvider="">
    <authorization>...</authorization>
    <providers>...</providers>
</personalization>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

defaultProvider

Atributo String opcional.

Establece el nombre del proveedor de personalización predeterminado de los elementos Web.

El valor predeterminado es .

"AspNetSqlPersonalizationProvider".

Elementos secundarios

Elemento

Descripción

authorization

Elemento opcional.

Establece las autorizaciones de personalización de elementos Web para la aplicación Web actual.

providers

Elemento opcional.

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

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.

Comentarios

Configuración predeterminada

El siguiente elemento personalization predeterminado se configura en el archivo Web.config raíz en la versión 2.0 de .NET Framework.

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

Ejemplo

En el ejemplo siguiente se muestra cómo configurar las opciones de personalización para una aplicación ASP.NET.

<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. Sin embargo, la autorización se puede definir por directorio local. Por consiguiente, hay que tener cuidado al definir ambos elementos en ámbitos diferentes para garantizar que sus valores no estén en conflicto.

Información de elemento

Controlador de secciones de configuración

System.Web.Configuration.WebPartsSection

Miembro de la configuración

WebPartsSection.Personalization

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config de nivel de aplicación

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

Requisitos

IIS versión 5.0, IIS versión 5.1 e IIS versión 6.0

.NET Framework 2.0

Visual Studio 2005

Vea también

Tareas

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referencia

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

Elemento configuration (Esquema de configuración general)

Elemento authorization para la personalización de 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)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

Conceptos

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API