SqlPersonalizationProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Implementiert einen Personalisierungsanbieter, der Microsoft SQL Server verwendet.
public ref class SqlPersonalizationProvider : System::Web::UI::WebControls::WebParts::PersonalizationProvider
public class SqlPersonalizationProvider : System.Web.UI.WebControls.WebParts.PersonalizationProvider
type SqlPersonalizationProvider = class
inherit PersonalizationProvider
Public Class SqlPersonalizationProvider
Inherits PersonalizationProvider
- Vererbung
Hinweise
Diese Klasse definiert die erforderliche Funktionalität für einen Personalisierungsanbieter mithilfe von Microsoft SQL Server. Ein Personalisierungsanbieter lädt und speichert Personalisierungsdaten im Auftrag einer WebPartPersonalization Instanz. Diese Klasse implementiert die Logik zum Lesen und Schreiben auf Computer, auf denen SQL Server ausgeführt wird, und implementiert auch alle abstrakten Methoden, die in PersonalizationProvider definiert sind. Weitere Informationen zu Personalisierungsanbietern finden Sie unter PersonalizationProvider.
Der Datenentwurf für die Verwendung der Webparts-Personalisierung mit SQL Server basiert auf dem Vorhandensein von zwei allgemeinen SQL-Datenbanktabellen und deren unterstützenden gespeicherten Prozeduren, die für die meisten SQL-basierten Featureimplementierungen freigegeben werden. Diese Tabellen und Ansichten werden mithilfe der folgenden Skripts installiert und deinstalliert:
installpagepersonalization.sql – Installiert die Personalisierungstabellen, Ansichten und zugehörigen gespeicherten Prozeduren.
uninstallpagepersonalization.sql – Deinstalliert die Personalisierungstabellen, Ansichten und zugehörigen gespeicherten Prozeduren.
Es ist wichtig zu beachten, dass die Personalisierung fehlschlägt, wenn Ihre Webanwendung nicht auf der Standardvertrauensstufe von Medium oder höher ausgeführt wird (Sie können benutzerdefinierte Vertrauensstufen in einer Web.config Datei mithilfe des <trust level="" /> Elements festlegen). Die PersonalizationAdministration Klassen und SqlPersonalizationProvider Klassen überprüfen beide, wann sie initialisiert werden, auf eine Vertrauensstufe Low . Wenn Sie ihre Anwendung so konfigurieren, dass sie auf vertrauende Ebene von Low ausgeführt wird, und Sie verwenden den Standardanbieter SqlPersonalizationProvider, um die Personalisierungsdaten für Ihre Anwendung zu verwalten. Wenn die Anwendung zum ersten Mal versucht, auf Personalisierungsdaten zuzugreifen, tritt ein Fehler auf, da ein ASP.NET Arbeitsprozess, der in Low Trust ausgeführt wird, nicht über die erforderlichen Berechtigungen zum Aufrufen der verschiedenen Klassen im namespace System.Data.SqlClient verfügt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SqlPersonalizationProvider() |
Initialisiert eine neue Instanz der SqlPersonalizationProvider-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ApplicationName |
Ruft den Namen der Anwendung ab, für die Personalisierungsinformationen gespeichert und abgerufen werden sollen, oder legt diesen fest. |
| Description |
Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist. (Geerbt von ProviderBase) |
| Name |
Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase) |
Methoden
| Name | Beschreibung |
|---|---|
| CreateSupportedUserCapabilities() |
Gibt eine Liste von WebPartUserCapability Objekten zurück, die den Satz bekannter Funktionen darstellen, die vom Webpart-Steuerelementsatz verwendet werden. (Geerbt von PersonalizationProvider) |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Bestimmt, ob der anfängliche Personalisierungsbereich sein Shared oder User den Bereich haben soll. (Geerbt von PersonalizationProvider) |
| DetermineUserCapabilities(WebPartManager) |
Gibt ein Wörterbuch zurück, das Instanzen enthält WebPartUserCapability , die die Personalisierungsfunktionen des derzeit ausgeführten Benutzerkontos darstellen. (Geerbt von PersonalizationProvider) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
Gibt eine Auflistung zurück, die null oder mehr PersonalizationStateInfoabgeleitete Objekte enthält, basierend auf dem angegebenen Bereich und den angegebenen Parametern. |
| GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
Gibt eine Anzahl der Zeilen im zugrunde liegenden Datenspeicher zurück, die für den angegebenen |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize(String, NameValueCollection) |
Implementiert die Initialisierungsverfahren, die für einen Microsoft SQL Server Personalisierungsanbieter erforderlich sind. Diese Methode soll nicht direkt aus Dem Code verwendet werden. |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
Lädt Personalisierungsdaten aus dem zugrunde liegenden Datenspeicher basierend auf den angegebenen Parametern. |
| LoadPersonalizationState(WebPartManager, Boolean) |
Lädt die Rohdaten aus dem zugrunde liegenden Datenspeicher und konvertiert diese Daten in ein PersonalizationState Objekt. (Geerbt von PersonalizationProvider) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
Personalisierungsdaten werden aus dem zugrunde liegenden Datenspeicher gelöscht. |
| ResetPersonalizationState(WebPartManager) |
Setzt Personalisierungsdaten auf den zugrunde liegenden Datenspeicher zurück. (Geerbt von PersonalizationProvider) |
| ResetState(PersonalizationScope, String[], String[]) |
Löscht Personalisierungsstatusinformationen aus dem zugrunde liegenden Datenspeicher basierend auf den angegebenen Parametern. |
| ResetUserState(String, DateTime) |
Löscht Benutzerpersonalisierungsdaten aus dem zugrunde liegenden Datenspeicher basierend auf den angegebenen Parametern. |
| SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
Speichert unformatierte Personalisierungsdaten in der zugrunde liegenden Microsoft SQL Server-Datenbank. |
| SavePersonalizationState(PersonalizationState) |
Speichert Personalisierungsdaten in einem Datenspeicher. (Geerbt von PersonalizationProvider) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |