PersonalizationScope 列舉

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

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

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

繼承

Object

ValueType

Enum

PersonalizationScope

欄位

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

範例

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

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

備註

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

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

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

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