PersonalizationScope Wyliczenie

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Wskazuje zakres WebPartManager personalizacji obiektu lub zakresu personalizacji, który ma zastosowanie do właściwości w kontrolce składników Web Part.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Dziedziczenie

Object

ValueType

Enum

PersonalizationScope

Pola

Shared	1	Podczas odwoływania się do zakresu kontrolki WebPartManager zakres oznacza, Shared że dane personalizacji dotyczą wszystkich użytkowników dla wszystkich kontrolek personalizowalnych na stronie, a także są dostępne do zapisania na stronie. Podczas odwoływania się do zakresu skojarzonego z właściwością kontrolki składników Web Part zakres wskazuje, Shared że właściwość zwykle zezwala tylko na ładowanie lub zapisywanie danych skojarzonych ze wszystkimi użytkownikami.
User	0	Podczas odwoływania się do zakresu kontrolki WebPartManager zakres oznacza, User że dane personalizacji, które są specyficzne dla użytkownika, a także dane personalizacji, które mają zastosowanie do wszystkich użytkowników, są ładowane do wszystkich kontrolek personalizowalnych na stronie. Na stronie można zapisywać tylko dane personalizacji specyficzne dla użytkownika. Podczas odwoływania się do zakresu skojarzonego z właściwością kontrolki składników Web Part zakres wskazuje, User że właściwość może ładować i przechowywać dane dotyczące wszystkich użytkowników podczas uruchamiania na stronie w Shared zakresie. Jednak gdy kontrolka właściwości jest uruchomiona na stronie w User zakresie, dane poszczególnych użytkowników i wszystkich użytkowników właściwości zostaną załadowane i scalone. W takim przypadku jednak tylko dane poszczególnych użytkowników zostaną zapisane, gdy strona jest uruchomiona w User zakresie zakresu.

Przykłady

W poniższym przykładzie pokazano użycie wyliczenia PersonalizationScope :

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

Uwagi

Zakres personalizacji to kluczowa koncepcja personalizacji składników Web Part i jest ściśle zintegrowana z innymi ustawieniami, w tym zakresem, w którym strona, za pośrednictwem WebPartManager kontrolki, jest uruchomiona; zakres skojarzony z każdą właściwością kontrolki i sposób, w jaki kontrolka została dodana do strony. Aby uzyskać więcej informacji na temat zakresu personalizacji, zobacz Omówienie personalizacji składników Web Part.

Zakres personalizacji odnosi się do sposobu, w jaki dane personalizacji mają zastosowanie do różnych zestawów użytkowników. Niektóre dane personalizacji mają zastosowanie tylko do określonego użytkownika i kontrolki na stronie. Inne dane personalizacji mają zastosowanie do wszystkich użytkowników, którzy wyświetlają witrynę. Zakres personalizacji jest używany w różnych obszarach personalizacji, aby wskazać, który zestaw danych należy pobrać i wyświetlić.

Gdy strona jest uruchomiona w Shared zakresie personalizacji, oznacza to, że należy załadować tylko dane personalizacji dla określonej kontrolki, mające zastosowanie do wszystkich użytkowników wyświetlających kontrolkę. W zależności od aktualnie wykonywanych praw użytkownika te szeroko stosowane dane można również modyfikować i zapisywać z powrotem w magazynie danych. Gdy strona jest uruchomiona w User zakresie personalizacji, oznacza to, że dane personalizacji kontrolki powinny zostać zapisane i załadowane na podstawie aktualnie wykonywanego użytkownika. Zwykle oznacza to, że dane specyficzne dla użytkownika można ładować i zapisywać w kontrolce, a dane (lub dane udostępnione) mogą być wyświetlane tylko w kontrolce.

Kontrolka WebPartManager , która zarządza cyklem życia personalizacji wysokiego poziomu, jest wykonywana w jednym z dwóch zakresów personalizacji.