personalization-Element für webParts (ASP.NET-Einstellungsschema)

  • Artikel

Gibt den Webparts-Personalisierungsanbieter an und legt Webparts-Personalisierungsautorisierungen fest.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

defaultProvider

Optionales String-Attribut.

Legt den Namen des Webparts-Standardpersonalisierungsanbieters fest.

Standardwert:

"AspNetSqlPersonalizationProvider".

Untergeordnete Elemente

Element

Beschreibung

authorization

Optionales Element

Legt die Webparts-Personalisierungsautorisierungen für die aktuelle Webanwendung fest.

providers

Optionales Element.

Legt die Webparts-Personalisierungsanbieter für die aktuelle Webanwendung fest.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das erforderliche Stammelement jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.web

Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen einer Konfigurationsdatei an. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

webParts

Ermöglicht es, einen Webparts-Personalisierungsanbieter anzugeben, Personalisierungsautorisierungen festzulegen und benutzerdefinierte Klassen hinzufügen, mit denen die WebPartTransformer-Klasse auf die Verwendung durch Webparts-Verbindungen erweitert wird.

Hinweise

Standardkonfiguration

Das folgende personalization-Standardelement wird in der Stammdatei Web.config von .NET Framework, Version 2.0, konfiguriert.

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

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Personalisierungseinstellungen für eine ASP.NET-Anwendung konfiguriert werden.

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

Anbieter werden möglicherweise nur auf Anwendungsebene definiert. Die Autorisierung kann jedoch pro lokales Verzeichnis definiert werden. Beim Definieren beider Elemente in unterschiedlichen Gültigkeitsbereichen muss daher sichergestellt werden, dass zwischen ihren Werten kein Konflikt auftritt.

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.WebPartsSection

Konfigurationsmember

WebPartsSection.Personalization

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse

Anforderungen

IIS, Version 5.0, IIS, Version 5.1, und IIS, Version 6.0

.NET Framework, Version 2.0

Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

authorization-Element für personalization für webParts (ASP.NET-Einstellungsschema)

providers-Element für personalization für webParts (ASP.NET-Einstellungsschema)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

Konzepte

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Absichern der ASP.NET-Konfiguration

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurations-API