PersonalizationScope Enumeration

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Gibt den Personalisierungsbereich für ein WebPartManager -Objekt oder den Personalisierungsbereich an, der für eine Eigenschaft eines Webpart-Steuerelements gilt.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Vererbung
Object
ValueType
Enum
PersonalizationScope

Felder

Name Wert Beschreibung
User 0

Wenn Sie auf den Bereich des WebPartManager Steuerelements verweisen, bedeutet der Bereich, User dass Personalisierungsdaten, die benutzerspezifisch sind, sowie Personalisierungsdaten, die für alle Benutzer gelten, für alle personalisierten Steuerelemente auf einer Seite geladen werden. Nur Personalisierungsdaten, die benutzerspezifisch sind, können auf der Seite gespeichert werden.
Wenn Sie auf den Bereich verweisen, der einer Webpart-Steuerelementeigenschaft zugeordnet ist, gibt der Bereich an, User dass die Eigenschaft nur Daten laden und speichern kann, die für alle Benutzer gelten, wenn sie auf einer Seite im Shared Bereich ausgeführt werden. Wenn das Steuerelement der Eigenschaft jedoch auf einer Seite im User Bereich ausgeführt wird, werden die Daten pro Benutzer und alle Benutzer geladen und zusammengeführt. In diesem Fall werden jedoch nur benutzerspezifische Daten gespeichert, wenn eine Seite im User Bereichsbereich ausgeführt wird.
Shared 1

Wenn Sie auf den Bereich des WebPartManager Steuerelements verweisen, bedeutet der Bereich, Shared dass Personalisierungsdaten für alle Benutzer für alle personalisierten Steuerelemente auf einer Seite gelten und auch auf der Seite gespeichert werden können.
Wenn Sie auf den Bereich verweisen, der einer Webpart-Steuerelementeigenschaft zugeordnet ist, gibt der Bereich an, Shared dass die Eigenschaft normalerweise nur das Laden oder Speichern von Daten zulässt, die allen Benutzern zugeordnet sind.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der PersonalizationScope Enumeration:

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

Hinweise

Der Personalisierungsbereich ist ein wichtiges Konzept in der Webpart-Personalisierung und ist eng in andere Einstellungen integriert, einschließlich des Bereichs, in dem die Seite über das WebPartManager Steuerelement ausgeführt wird; der Bereich, der jeder Eigenschaft eines Steuerelements zugeordnet ist, und die Art und Weise, in der das Steuerelement der Seite hinzugefügt wurde. Weitere Informationen zum Personalisierungsbereich finden Sie unter "Webparts Personalization Overview".

Der Personalisierungsbereich bezieht sich auf die Anwendbarkeit von Personalisierungsdaten auf verschiedene Benutzergruppen. Einige Personalisierungsdaten gelten nur für einen bestimmten Benutzer und ein Bestimmtes Steuerelement auf einer Seite. Andere Personalisierungsdaten gelten für alle Benutzer, die eine Website anzeigen. Der Personalisierungsbereich wird in verschiedenen Bereichen der Personalisierung verwendet, um anzugeben, welche Datenmenge abgerufen und angezeigt werden soll.

Wenn eine Seite im Shared Personalisierungsbereich ausgeführt wird, gibt dies an, dass nur die Personalisierungsdaten für ein bestimmtes Steuerelement, das für alle Benutzer, die das Steuerelement anzeigen, geladen werden sollten. Je nach den aktuell ausgeführten Rechten des Benutzers können diese allgemein anwendbaren Daten auch geändert und wieder im Datenspeicher gespeichert werden. Wenn eine Seite im User Personalisierungsbereich ausgeführt wird, gibt dies an, dass die Personalisierungsdaten eines Steuerelements basierend auf dem aktuell ausgeführten Benutzer gespeichert und geladen werden sollen. Dies bedeutet in der Regel, dass benutzerspezifische Daten in einem Steuerelement geladen und gespeichert werden können, während allgemein anwendbare Daten (oder freigegebene Daten) nur für das Steuerelement angezeigt werden können.

Ein WebPartManager Steuerelement, das den allgemeinen Lebenszyklus der Personalisierung verwaltet, wird in einem der beiden Personalisierungsbereiche ausgeführt.

Gilt für: