SqlPersonalizationProvider 類別

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

實作使用 Microsoft SQL Server 的個人化提供者。

public ref class SqlPersonalizationProvider : System::Web::UI::WebControls::WebParts::PersonalizationProvider

public class SqlPersonalizationProvider : System.Web.UI.WebControls.WebParts.PersonalizationProvider

type SqlPersonalizationProvider = class
    inherit PersonalizationProvider

Public Class SqlPersonalizationProvider
Inherits PersonalizationProvider

繼承

Object

ProviderBase

PersonalizationProvider

SqlPersonalizationProvider

備註

這個類別會使用Microsoft SQL Server來定義個人化提供者的必要功能。 個人化提供者會代表 WebPartPersonalization 實例載入和儲存個人化資料。 這個類別會實作讀取和寫入執行SQL Server之電腦的邏輯，也會實作 中 PersonalizationProvider 定義的所有抽象方法。 如需個人化提供者的詳細資訊，請參閱 PersonalizationProvider 。

搭配使用 Web 元件個人化與SQL Server的資料設計依賴兩個常見的 SQL 資料庫資料表及其支援的預存程式，這些預存程式會針對大部分 SQL 型功能實作共用。 這些資料表和檢視會使用下列腳本來安裝和卸載：

• installpagepersonalization.sql - 安裝個人化資料表、檢視和相關預存程式。

• uninstallpagepersonalization.sql - 卸載個人化資料表、檢視和相關預存程式。

請務必注意，如果您的 Web 應用程式未在預設信任層級或更新版本執行， (您可以使用 元素) 在Web.config檔案 <trust level="" /> 中設定自訂信任層級 Medium ，個人化將會失敗。 PersonalizationAdministration和 SqlPersonalizationProvider 類別會在初始化時檢查 的信任層級 Low 。 如果您將應用程式設定為在 的信任層級 Low 執行，並使用預設 SqlPersonalizationProvider 提供者來管理應用程式的個人化資料，則第一次應用程式嘗試存取個人化資料時，將會失敗，因為信任中 Low 執行的 ASP.NET 背景工作進程沒有呼叫命名空間中 System.Data.SqlClient 各種類別所需的許可權。

建構函式

SqlPersonalizationProvider()

初始化 SqlPersonalizationProvider 類別的新執行個體。

屬性

ApplicationName	取得或設定應用程式的名稱，以儲存和擷取個人化資訊。
Description	取得簡短、易讀的描述，適合顯示在管理工具或其他使用者介面 (UI) 中。 (繼承來源 ProviderBase)
Name	取得用來在設定期間代表提供者的易記名稱。 (繼承來源 ProviderBase)

方法

CreateSupportedUserCapabilities()	傳回 WebPartUserCapability 物件清單，表示 Web 組件控制集使用的一組已知能力。 (繼承來源 PersonalizationProvider)
DetermineInitialScope(WebPartManager, PersonalizationState)	決定初始個人化範圍應當是 Shared 還是 User 範圍。 (繼承來源 PersonalizationProvider)
DetermineUserCapabilities(WebPartManager)	傳回包含 WebPartUserCapability 執行個體的字典，表示目前執行之使用者帳戶的個人化相關能力。 (繼承來源 PersonalizationProvider)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	根據指定的範圍和參數，傳回包含零或多個 PersonalizationStateInfo 衍生物件的集合。
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)	傳回基礎資料存放區中針對特定 scope 參數而存在的資料列數目。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Initialize(String, NameValueCollection)	實作 Microsoft SQL Server 個人化提供者所需的初始化程序。 這個方法不能從程式碼直接使用。
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])	根據指定的參數，載入基礎資料存放區中的個人化資料。
LoadPersonalizationState(WebPartManager, Boolean)	從基礎資料存放區載入未經處理的資料，並將該資料轉換成 PersonalizationState 物件。 (繼承來源 PersonalizationProvider)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ResetPersonalizationBlob(WebPartManager, String, String)	刪除基礎資料存放區中的個人化資料。
ResetPersonalizationState(WebPartManager)	將個人化資料重設至基礎資料存放區。 (繼承來源 PersonalizationProvider)
ResetState(PersonalizationScope, String[], String[])	根據指定的參數，刪除基礎資料存放區中的個人化狀態資訊。
ResetUserState(String, DateTime)	根據指定的參數，刪除基礎資料存放區中的使用者個人化資料。
SavePersonalizationBlob(WebPartManager, String, String, Byte[])	將未經處理的個人化資料儲存至基礎 Microsoft SQL Server 資料庫。
SavePersonalizationState(PersonalizationState)	將個人化資料儲存至資料存放區。 (繼承來源 PersonalizationProvider)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• PersonalizationProvider
• ASP.NET 網頁元件控制項
• Web 元件個人化概觀
• 逐步解說：使用使用者控制項實作 Web 元件個人化
• 網頁元件個人化