webParts-Element (ASP.NET-Einstellungsschema)

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

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.

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

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

enableExport

Optionales Boolean-Attribut.

Aktiviert den Export von Steuerelementdaten in eine XML-Beschreibungsdatei.

Der Standardwert ist false.

Untergeordnete Elemente

Element

Beschreibung

personalization

Optionales Element.

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

transformers

Optionales Element.

Definiert eine Auflistung von TransformerInfo-Objekten.

Ü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 in einer Konfigurationsdatei an. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

Hinweise

Standardkonfiguration

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

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

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Werte für den webParts-Abschnitt deklarativ angegeben 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.

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.WebPartsSection

Konfigurationsmember

SystemWebSectionGroup.WebParts

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 6.0

.NET Framework, Version 2.0

Visual Studio 2005

Siehe auch

Aufgaben

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referenz

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

configuration-Element (allgemeines Einstellungsschema)

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

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

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

Konzepte

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Configuring ASP.NET Applications

ASP.NET Configuration API