語言

PersonalizationScope 列舉

定義

指出 WebPartManager 對象的個人化範圍,或套用至網頁元件控件上屬性的個人化範圍。

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
繼承
PersonalizationScope

欄位

名稱 值 Description
User 0

在控制項中提及範圍 WebPartManager 時, User 範圍指的是針對頁面上所有可個人化控制的個人化資料,以及適用於所有使用者的個人化資料。 頁面上僅能儲存使用者專屬的個人化資料。
當提及與 Web Parts 控制屬性相關的範圍時, User 範圍表示該屬性只能在作用域內的頁面 Shared 上載入並儲存適用於所有使用者的資料。 然而,當屬性的控制項在範圍內的頁面 User 上執行時,屬性的每位使用者與所有使用者的資料會被載入並合併。 但在此情況下,當頁面在作用域範圍內執行 User 時,只會儲存每位使用者的資料。

Shared 1

在控制項中提及範圍 WebPartManager 時, Shared 範圍指的是個人化資料適用於所有頁面上所有可個人化控制的使用者,且也可儲存在頁面上。
當提及與 Web Parts 控制屬性相關的範圍時, Shared 範圍表示該屬性通常只允許載入或儲存所有使用者相關資料。

範例

以下範例展示了使用列 PersonalizationScope 舉的方法:

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

備註

個人化範圍是網頁零件個人化中的關鍵概念,並與其他設定緊密整合,包括頁面 WebPartManager 透過控制項運行的範圍、控制項上每個屬性所關聯的範圍;以及控制項如何被加入頁面。 欲了解更多個人化範圍資訊,請參閱 網頁部分個人化概述。

個人化範圍指的是個人化資料如何適用於不同使用者群。 部分個人化資料僅適用於頁面上的特定使用者與控制。 其他個人化資料適用於所有瀏覽網站的使用者。 個人化範圍在個人化的各個領域中被用來指示應該檢索並顯示哪組資料。

當頁面在個人化範圍內執行 Shared 時,表示僅應載入特定控制項的個人化資料,適用於所有使用者。 根據當前執行使用者的權利,這些廣泛適用的資料也可以被修改並儲存回資料儲存庫。 當頁面在個人化範圍內執行 User 時,表示控制項的個人化資料應根據目前執行的使用者來儲存並載入。 通常,這表示使用者專屬的資料可以載入並儲存在控制器上,而廣泛適用的資料(或共享資料)只能在控制器上查看。

一個 WebPartManager 控制項負責管理個人化的高階生命週期,執行於兩個個人化範圍之一。

適用於