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 auf eine Eigenschaft eines Webparts-Steuerelements angewendet wird.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Vererbung

Object

ValueType

Enum

PersonalizationScope

Felder

Shared	1	Wenn es sich um den Gültigkeitsbereich für das WebPartManager-Steuerelement handelt, bedeutet Shared-Bereich, dass Personalisierungsdaten auf alle Benutzer für alle personalisierbaren Steuerelemente auf einer Seite angewendet und auch auf der Seite gespeichert werden können. Beim Verweis auf den Bereich, der einer Eigenschaft eines Webparts-Steuerelements zugeordnet ist, gibt der Shared-Bereich an, dass die Eigenschaft normalerweise nur das Laden oder Speichern von Daten ermöglicht, die allen Benutzern zugeordnet sind.
User	0	Wenn es sich um einen Gültigkeitsbereich für das WebPartManager-Steuerelement handelt, bedeutet User-Bereich, dass sowohl benutzerspezifische als auch auf alle Benutzer anwendbare Personalisierungsdaten für alle personalisierbaren Steuerelemente auf einer Seite geladen werden. Auf der Seite können nur Personalisierungsdaten gespeichert werden, die benutzerspezifisch sind. Beim Verweis auf den Bereich, der einer Eigenschaft eines Webparts-Steuerelement zugeordnet ist, gibt der User-Bereich an, dass die Eigenschaft bei Ausführung auf einer Seite im Shared-Bereich nur Daten laden und speichern kann, die für alle Benutzer gelten. Wenn das Steuerelement der Eigenschaft jedoch auf einer Seite im User Bereich ausgeführt wird, werden die Daten pro Benutzer und alle Benutzer der Eigenschaft geladen und zusammengeführt. In diesem Fall werden jedoch nur Benutzerdaten gespeichert, wenn eine Seite im User Bereich ausgeführt wird.

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 Schlüsselkonzept bei der Personalisierung von Webparts und ist eng in andere Einstellungen integriert, einschließlich des Bereichs, in dem die Seite über das WebPartManager -Steuerelement ausgeführt wird, der den einzelnen Eigenschaften eines Steuerelements zugeordnete Bereich und die Art und Weise, in der das Steuerelement der Seite hinzugefügt wurde. Weitere Informationen zum Personalisierungsbereich finden Sie unter Übersicht über die Webparts-Personalisierung.

Der Personalisierungsbereich bezieht sich darauf, wie Personalisierungsdaten für verschiedene Gruppen von Benutzern anwendbar sind. 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, welcher Datensatz abgerufen und angezeigt werden soll.

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

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