PersonalizationScope Výčet

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Určuje rozsah přizpůsobení objektu WebPartManager nebo rozsah přizpůsobení, který se vztahuje na vlastnost ovládacího prvku webové části.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Dědičnost

Object

ValueType

Enum

PersonalizationScope

Pole

Shared	1	Pokud odkazujete na WebPartManager rozsah ovládacího prvku, rozsah znamená, Shared že individuální údaje platí pro všechny uživatele pro všechny přizpůsobitelné ovládací prvky na stránce a jsou také k dispozici k uložení na stránce. Při odkazování na obor přidružený k vlastnosti ovládacího prvku webových částí obor označuje, Shared že vlastnost normálně umožňuje pouze načítání nebo ukládání dat přidružených ke všem uživatelům.
User	0	Pokud odkazujete na WebPartManager rozsah ovládacího prvku, rozsah znamená, User že data přizpůsobení, která jsou specifická pro uživatele, a také data přizpůsobení, která platí pro všechny uživatele, se načtou pro všechny přizpůsobitelné ovládací prvky na stránce. Na stránce je možné uložit pouze data individuálního nastavení, která jsou specifická pro uživatele. Pokud odkazujete na obor přidružený k vlastnosti ovládacího prvku webových částí, obor označuje, User že vlastnost může načíst a uložit pouze data použitelná pro všechny uživatele při spuštění na stránce v Shared oboru. Pokud je však ovládací prvek vlastnosti spuštěn na stránce v User oboru, načtou se a sloučí data vlastnosti pro uživatele a všechny uživatele. V tomto případě se ale budou ukládat jenom uživatelská data, pokud stránka běží v User oboru.

Příklady

Následující příklad ukazuje použití výčtu PersonalizationScope :

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

Poznámky

Rozsah přizpůsobení je klíčovým konceptem při individuálním přizpůsobení webových částí a je úzce integrován s dalšími nastaveními, včetně rozsahu, ve kterém stránka prostřednictvím WebPartManager ovládacího prvku běží, oboru přidruženého k jednotlivým vlastnostem ovládacího prvku a způsobu, jakým byl ovládací prvek přidán na stránku. Další informace o rozsahu přizpůsobení najdete v tématu Přehled přizpůsobení webových částí.

Rozsah přizpůsobení odkazuje na to, jak jsou data přizpůsobení použitelná pro různé skupiny uživatelů. Některá data přizpůsobení jsou použitelná jenom pro konkrétního uživatele a ovládací prvek na stránce. Další data přizpůsobení jsou použitelná pro všechny uživatele, kteří si web prohlížejí. Rozsah přizpůsobení se používá v různých oblastech přizpůsobení k určení, která sada dat se má načíst a zobrazit.

Pokud stránka běží v Shared oboru přizpůsobení, znamená to, že by se měla načíst pouze data přizpůsobení pro konkrétní ovládací prvek, která platí pro všechny uživatele, kteří si ovládací prvek prohlížejí. V závislosti na právech aktuálně spuštěného uživatele je možné tato široce použitelná data také upravit a uložit zpět do úložiště dat. Pokud stránka běží v User oboru přizpůsobení, znamená to, že data přizpůsobení ovládacího prvku by měla být uložena a načtena na základě aktuálně spuštěného uživatele. Obvykle to znamená, že data specifická pro uživatele se dají načíst a uložit do ovládacího prvku, zatímco široce použitelná data (nebo sdílená data) se dají zobrazit jenom na ovládacím prvku.

Ovládací WebPartManager prvek, který spravuje základní životní cyklus přizpůsobení, se spustí v jednom ze dvou rozsahů přizpůsobení.