Język

PersonalizationScope Wyliczenie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Wskazuje zakres personalizacji dla obiektu WebPartManager 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

Nazwa Wartość Opis
User 0

Podczas odwoływania się do zakresu kontrolki WebPartManager zakres oznacza, User że dane personalizacji specyficzne dla użytkownika, a także dane personalizacji, które mają zastosowanie do wszystkich użytkowników, są ładowane dla wszystkich kontrolek z możliwością personalizacji na stronie. Na stronie można zapisywać tylko dane personalizacji specyficzne dla użytkownika.
W przypadku 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, właściwość dla użytkownika i wszystkie dane użytkownika zostaną załadowane i scalone. W takim przypadku jednak tylko dane poszczególnych użytkowników będą zapisywane, gdy strona jest uruchomiona w User zakresie zakresu.
Shared 1

W przypadku odwoływania się do zakresu kontrolki WebPartManager zakres oznacza, Shared że dane personalizacji dotyczą wszystkich użytkowników dla wszystkich kontrolek z możliwością personalizacji na stronie i są również 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.

Przykłady

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

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 oraz sposób, w jaki kontrolka została dodana do strony. Aby uzyskać więcej informacji na temat zakresu personalizacji, zobacz Web Part Personalization Overview (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 kontroli 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 mogą być również modyfikowane i zapisywane 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. Zazwyczaj oznacza to, że dane specyficzne dla użytkownika mogą być ładowane i zapisywane w kontrolce, natomiast szeroko stosowane 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.

Dotyczy