PersonalizationProvider Klasse

Definition

Implementiert die Basisfunktionalität für einen Personalisierungsanbieter.Implements the basic functionality for a personalization provider.

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
type PersonalizationProvider = class
    inherit ProviderBase
Public MustInherit Class PersonalizationProvider
Inherits ProviderBase
Vererbung
PersonalizationProvider
Abgeleitet

Hinweise

Dies ist die abstrakte Basisklasse, die die erforderliche Funktionalität eines Personalisierungs Anbieters definiert.This is the abstract base class that defines the required functionality of a personalization provider. Ein Personalisierungs Anbieter lädt und speichert Personalisierungs Daten im Namen einer WebPartPersonalization -Instanz.A personalization provider both loads and stores personalization data on behalf of a WebPartPersonalization instance.

Die-Basisklasse definiert das Standardverhalten für eine Reihe von Methoden. nur die Methoden, die speziell mit dem zugrunde liegenden Datenspeicher behandelt werden, sind als abstrakt gekennzeichnet.The base class defines standard behavior for a number of methods; only those methods that specifically deal with the underlying data store are marked abstract. Dies ermöglicht es einem Entwickler, einen benutzerdefinierten Anbieter für die Interaktion mit einem bestimmten Datenspeicher zu schreiben, ohne die von der WebPartPersonalization -Klasse verwendete Standardfunktionalität neu implementieren zu müssen.This allows a developer to write a custom provider to interact with a specific data store, without needing to re-implement standard functionality used by the WebPartPersonalization class.

Hinweise für Ausführende

Sie können von PersonalizationProvider ableiten und Implementierungen nur für die in dieser Klasse definierten abstrakten Methoden bereitstellen.You can derive from PersonalizationProvider and provide implementations for only the abstract methods defined in this class. Die abstrakten Methoden befassen sich insbesondere mit dem Speichern und Laden von Daten in einen physischen Datenspeicher und mit der Datenspeicher Verwaltung.The abstract methods deal specifically with saving and loading data to a physical data store, and with data store administration. Ein benutzerdefinierter Anbieter muss in der Lage sein, Personalisierungs Informationen so zu manipulieren Shared , dass User Daten von Daten unterschieden werden.A custom provider must be capable of manipulating personalization information in a manner that distinguishes Shared data from User data. Darüber hinaus muss ein Anbieter Personalisierungs Daten sowohl nach Seite als auch nach Anwendung segmentieren.Furthermore, a provider must segment personalization data by page as well as by application.

Implementierungen von PersonalizationProvider sind eng an Implementierungen von PersonalizationState gekoppelt, da einige Personalisierungs Anbieter Methoden Instanzen von PersonalizationStatevon abgeleiteten Klassen zurückgeben.Implementations of PersonalizationProvider are tightly coupled to implementations of PersonalizationState because some personalization provider methods return instances of PersonalizationState-derived classes. Um die Entwicklung von benutzerdefinierten Anbietern zu PersonalizationProvider vereinfachen, enthält die-Basisklasse eine Standard Implementierung der Logik-und Serialisierungs-/Deserialisierungslogik, die WebPartPersonalization direkt von der-Klasse verwendet wird.To ease development of custom providers, the PersonalizationProvider base class includes a default implementation of the personalization logic and serialization/deserialization logic that is used directly by the WebPartPersonalization class. Daher erfordert das Erstellen eines benutzerdefinierten Anbieters ausschließlich zum Zweck der Arbeit mit einem anderen Datenspeicher nur die Implementierung der folgenden abstrakten Methoden:As a result, authoring a custom provider solely for the purpose of working with a different data store only requires implementation of the following abstract methods:

  • GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - This method needs to be able to count the number of rows of personalization data in the database for the supplied query parameters.

  • LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])-Bei Angabe des Pfads und des Benutzernamens lädt diese Methode zwei BLOBs (Binary Large Objects) aus der Datenbank: ein BLOB für freigegebene Daten und eine für Benutzerdaten.
  • LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Given the path and user name, this method loads two binary large objects (BLOBs) from the database: one BLOB for shared data and one for user data.
  • Wenn Sie den Benutzernamen und den Pfad angeben, benötigen Sie das WebPartManager Steuerelement nicht für den Zugriff auf die Seiten Informationen, die die Benutzernamen-/Pfadinformationen bereitstellen können.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.
  • ResetPersonalizationBlob(WebPartManager, String, String)-Bei Angabe des Pfads und des Benutzernamens löscht diese Methode die entsprechende Zeile in der Datenbank.
  • ResetPersonalizationBlob(WebPartManager, String, String) - Given the path and user name, this method deletes the corresponding row in the database.
  • Wenn Sie den Benutzernamen und den Pfad angeben, benötigen Sie das WebPartManager Steuerelement nicht für den Zugriff auf die Seiten Informationen, die die Benutzernamen-/Pfadinformationen bereitstellen können.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.
  • SavePersonalizationBlob(WebPartManager, String, String, Byte[])-Bei Angabe des Pfads und des Benutzernamens speichert diese Methode das angegebene BLOB in der Datenbank.
  • SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Given the path and user name, this method saves the supplied BLOB to the database.
  • Wenn Sie den Benutzernamen und den Pfad angeben, benötigen Sie das WebPartManager Steuerelement nicht für den Zugriff auf die Seiten Informationen, die die Benutzernamen-/Pfadinformationen bereitstellen können.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.

    Wenn bei all diesen Methoden nur ein Pfad bereitgestellt wird, gibt dies an, dass die freigegebenen Personalisierungs Daten für die Seite verarbeitet werden.In all of these methods, if only a path is supplied, that indicates the shared personalization data for the page is being operated upon. Wenn sowohl ein Pfad als auch ein Benutzername an eine Methode weitergegeben werden, sollten die Benutzer Personalisierungs Daten für die Seite verarbeitet werden.If both a path and a username are passed to a method, then the user personalization data for the page should be acted upon. Im Fall von LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])sollten die freigegebenen Daten für den angegebenen Pfad immer geladen werden, und optional sollten auch die Benutzer Personalisierungs Daten für den Pfad geladen werden, wenn der Benutzername nicht nullist.In the case of LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), the shared data for the specified path should always be loaded, and optionally the user personalization data for the path should also be loaded if the username is not null.

    Alle anderen abstrakten Methoden sind nur für die Verwendung in administrativen Anwendungen vorgesehen und werden nicht von der Webparts-Infrastruktur zur Laufzeit verwendet.All other abstract methods are intended for use only in administrative applications and are not used by the Web Parts infrastructure at run time. Ein Beispiel für eine Implementierung eines Personalisierungs Anbieters finden Sie in der SqlPersonalizationProvider -Klasse.For an example of an implementation of a personalization provider, see the SqlPersonalizationProvider class.

    Konstruktoren

    PersonalizationProvider()

    Initialisiert eine neue Instanz der PersonalizationProvider-Klasse.Initializes a new instance of the PersonalizationProvider class.

    Eigenschaften

    ApplicationName

    Ruft den Namen der für den Anbieter konfigurierten Anwendung ab bzw. legt ihn fest, wenn der Name in einer abgeleiteten Klasse überschrieben wird.When overridden in a derived class, gets or sets the name of the application configured for the provider.

    Description

    Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

    (Geerbt von ProviderBase)
    Name

    Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.Gets the friendly name used to refer to the provider during configuration.

    (Geerbt von ProviderBase)

    Methoden

    CreateSupportedUserCapabilities()

    Gibt eine Liste von WebPartUserCapability-Objekten zurück, die die vom Webparts-Steuerelementsatz verwendeten bekannten Funktionen darstellen.Returns a list of WebPartUserCapability objects that represent the set of known capabilities used by the Web Parts control set.

    DetermineInitialScope(WebPartManager, PersonalizationState)

    Bestimmt, ob der ursprüngliche Personalisierungsbereich der Shared-Bereich oder der User-Bereich sein soll.Determines whether the initial personalization scope should be Shared or User scope.

    DetermineUserCapabilities(WebPartManager)

    Gibt ein Wörterbuch mit WebPartUserCapability-Instanzen zurück, die die personalisierungsbezogenen Funktionen des aktuell ausgeführten Benutzerkontos darstellen.Returns a dictionary containing WebPartUserCapability instances that represent the personalization-related capabilities of the currently executing user account.

    Equals(Object)

    Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

    (Geerbt von Object)
    FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)

    Wenn in einer abgeleiteten Klasse überschrieben, wird basierend auf dem angegebenen Bereich und den angegebenen Parametern eine Auflistung mit 0 oder mehr von PersonalizationStateInfo abgeleiteten Objekten zurückgegeben.When overridden in a derived class, returns a collection containing zero or more PersonalizationStateInfo-derived objects based on scope and specific query parameters.

    GetCountOfState(PersonalizationScope, PersonalizationStateQuery)

    Wenn in einer abgeleiteten Klasse überschrieben, wird die Anzahl der Zeilen im zugrunde liegenden Datenspeicher zurückgegeben, die innerhalb des angegebenen Bereichs vorhanden sind.When overridden in a derived class, returns the number of rows in the underlying data store that exist within the specified scope.

    GetHashCode()

    Dient als die Standard-HashfunktionServes as the default hash function.

    (Geerbt von Object)
    GetType()

    Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

    (Geerbt von Object)
    Initialize(String, NameValueCollection)

    Initialisiert den Konfigurations-Generator.Initializes the configuration builder.

    (Geerbt von ProviderBase)
    LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])

    Wenn in einer abgeleiteten Klasse überschrieben, werden Personalisierungsrohdaten aus dem zugrunde liegenden Datenspeicher geladen.When overridden in a derived class, loads raw personalization data from the underlying data store.

    LoadPersonalizationState(WebPartManager, Boolean)

    Lädt die Rohdaten aus dem zugrunde liegenden Datenspeicher und konvertiert diese Daten in ein PersonalizationState-Objekt.Loads the raw data from the underlying data store and converts that data into a PersonalizationState object.

    MemberwiseClone()

    Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

    (Geerbt von Object)
    ResetPersonalizationBlob(WebPartManager, String, String)

    Wenn in einer abgeleiteten Klasse überschrieben, werden Personalisierungsrohdaten aus dem zugrunde liegenden Datenspeicher gelöscht.When overridden in a derived class, deletes raw personalization data from the underlying data store.

    ResetPersonalizationState(WebPartManager)

    Setzt Personalisierungsdaten auf den zugrunde liegenden Datenspeicher zurück.Resets personalization data to the underlying data store.

    ResetState(PersonalizationScope, String[], String[])

    Wenn in einer abgeleiteten Klasse überschrieben, wird der Personalisierungszustand aus dem zugrunde liegenden Datenspeicher basierend auf den festgelegten Parametern gelöscht.When overridden in a derived class, deletes personalization state from the underlying data store based on the specified parameters.

    ResetUserState(String, DateTime)

    Wenn in einer abgeleiteten Klasse überschrieben, werden Webparts-Personalisierungsdaten im zugrunde liegenden Datenspeicher basierend auf den festgelegten Parametern gelöscht.When overridden in a derived class, deletes Web Parts personalization data from the underlying data store based on the specified parameters.

    SavePersonalizationBlob(WebPartManager, String, String, Byte[])

    Wenn in einer abgeleiteten Klasse überschrieben, werden Personalisierungsrohdaten im zugrunde liegenden Datenspeicher gespeichert.When overridden in a derived class, saves raw personalization data to the underlying data store.

    SavePersonalizationState(PersonalizationState)

    Speichert Personalisierungsdaten in einen Datenspeicher.Saves personalization data to a data store.

    ToString()

    Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

    (Geerbt von Object)

    Gilt für:

    Siehe auch