Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bestimmt den Namen des Anbieters und die Klasse, die ihn implementiert.
<add name="String"
type="String"
connectionStringName="String"
applicationName="String"
commandTimeout="number"/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
applicationName |
Optionales String-Attribut. Gibt den Namen der Anwendung an, für die Personalisierungsinformationen gespeichert und abgerufen werden sollen. |
connectionStringName |
Erforderliches String-Attribut. Gibt die anbieterspezifische SQL-Zeichenfolge an, mit der eine Verbindung mit der Datenbank hergestellt wird. |
commandTimeout |
Optionales Int32-Attribut. Legt die Anzahl der Sekunden fest, nach der ein an die Webparts-Personalisierungsdatenquelle ausgegebener Befehl wegen der angegebenen Zeitbeschränkung abgebrochen wird. Dieses Timeout wird vom SQL-Anbieter beim Erstellen von SqlCommand-Objekten verwendet. Dieses Attribut ist in der ASP.NET-Konfiguration nicht standardmäßig festgelegt. Daher wird die ADO.NET-Standardeinstellung von 30 Sekunden verwendet. Wenn dieses Attribut festgelegt ist, verwendet der SQL-Anbieter den konfigurierten Timeout-Wert für alle an die Datenbank ausgegebenen SQL-Befehle. |
name |
Erforderliches String-Attribut. Der angezeigte Name des Anbieters. |
type |
Erforderliches String-Attribut. Gibt einen vollqualifizierten Assemblyverweis auf eine Klasse an, die die PersonalizationProvider-Basisklasse implementiert. Abhängig davon, wo sich der Code mit dem Anbieter befindet, kann dies entweder ein partieller Verweis sein (z. B. nur Namespace.ClassName oder Namespace.Classname, AssemblyName), oder es kann ein vollqualifizierter Assemblyverweis auf eine Klasse sein, die die PersonalizationProvider-Basisklasse implementiert. |
Untergeordnete Elemente
Keine.
Ü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. |
personalization |
Gibt den Webparts-Personalisierungsanbieter an und legt Webparts-Personalisierungsautorisierungen fest. |
providers |
Definiert die Webparts-Personalisierungsanbieter für die aktuelle Webanwendung. |
Hinweise
Es muss berücksichtigt werden, dass Fehler bei der Personalisierung auftreten, wenn die Webanwendung nicht mit der mittleren Vertrauensebene (Standard) oder höher ausgeführt wird. (Benutzerdefinierte Vertrauensebenen können in einer Web.config-Datei mithilfe des <trust level="" />-Elements festgelegt werden.) Die PersonalizationAdministration-Klasse und die SqlPersonalizationProvider-Klasse überprüfen bei ihrer Initialisierung auf eine Vertrauensebene von Low. Wenn Sie die Anwendung zum Ausführen mit der Vertrauensebene Low konfigurieren, und Sie mit dem Standard-SqlPersonalizationProvider die Personalisierungsdaten der Anwendung verwalten, treten Fehler beim ersten Versuch der Anwendung auf, auf die Personalisierungsdaten zuzugreifen. Dies geschieht, weil ein ASP.NET-Arbeitsprozess, der mit der Vertrauensebene Low ausgeführt wird, nicht über die erforderlichen Berechtigungen zum Aufrufen der Klassen im System.Data.SqlClient-Namespace verfügt.
Standardkonfiguration
Das folgende add-Standardelement wird in der Web.config-Stammdatei von .NET Framework, Version 2.0, konfiguriert.
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer"
/>
</providers>
Beispiel
Das folgende Beispiel zeigt, wie ein Anbieter hinzugefügt wird.
<webParts>
<personalization defaultProvider="AspNetSqlPersonalizationProvider">
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer"
applicationName="/" />
</providers>
</personalization>
</webParts>
Anbieter werden möglicherweise nur auf Computer-, Website- oder Anwendungsebene definiert.
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
IIS 5.0, 5.1 und 6.0 .NET Framework 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)
clear-Element für providers für webParts (ASP.NET-Einstellungsschema)
remove-Element für providers für webParts (ASP.NET-Einstellungsschema)
Konzepte
Übersicht über die ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Absichern der ASP.NET-Konfiguration
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)