PersonalizationScope 列舉

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

表示 WebPartManager 物件的個人化範圍，或套用至 Web 組件控制項上屬性的個人化範圍。

C#

public enum PersonalizationScope

繼承

Object

ValueType

Enum

PersonalizationScope

欄位

名稱	值	Description
Shared	1	在參照 WebPartManager 控制項上的範圍時，Shared 範圍的意義是，個人化資料套用至頁面上所有個人化控制項的所有使用者，並且也可儲存在頁面上。 參考與 Web 組件控制屬性相關的範圍時，Shared 範圍會指出屬性只允許載入或儲存與所有使用者相關的資料。
User	0	在參照 WebPartManager 控制項上的範圍時，User 範圍是指：針對頁面上所有可個人化控制項載入的特定使用者個人化資料，以及適用於所有使用者的個人化資料。 只有使用者專屬的個人化資料可以儲存在頁面上。 參考與 Web 組件控制屬性相關的範圍時，User 範圍會指出在 Shared 範圍內執行頁面時，屬性只能載入和儲存適用於所有使用者的資料。 不過，當屬性的控件在範圍中的頁面上 User 執行時，將會載入和合併屬性的每個使用者和所有用戶數據。 不過，在此情況下，只有在頁面在 User 範圍範圍內執行時，才會儲存每個用戶的數據。

範例

下列範例示範如何使用 PersonalizationScope 列舉：

C#

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

備註

個人化範圍是 Web 元件個人化的重要概念，並與其他設定緊密整合，包括頁面 WebPartManager 透過控件執行的範圍;控件上每個屬性相關聯的範圍;以及控件新增至頁面的方式。 如需個人化範圍的詳細資訊，請參閱 Web 元件個人化概觀。

個人化範圍是指個人化數據如何適用於不同的使用者集合。 某些個人化數據僅適用於頁面上的特定使用者和控制。 其他個人化數據適用於檢視網站的所有使用者。 個人化範圍用於各種個人化區域，以指出應該擷取和顯示哪一組數據。

當頁面在個人化範圍中 Shared 執行時，這表示應該載入僅適用於檢視控件之所有使用者的特定控件個人化數據。 根據目前執行中用戶的許可權，此廣泛適用的數據也可以修改並儲存回數據存放區。 當頁面在個人化範圍中 User 執行時，這表示控件的個人化數據應該根據目前執行中的用戶來儲存和載入。 通常，這表示使用者特定的數據可以載入並儲存在控件上，而廣泛適用的數據 (或共用數據) 只能檢視控件。

WebPartManager管理個人化高階生命週期的控件會在兩個個人化範圍的其中一個中執行。

適用於