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。

SQL Serverで Web パーツのパーソナル化を使用するためのデータ設計は、ほとんどの SQL ベースの機能実装で共有される 2 つの共通 SQL データベース テーブルとそのサポート ストアド プロシージャの存在に依存します。 これらのテーブルとビューは、次のスクリプトを使用してインストールおよびアンインストールされます。

• installpagepersonalization.sql - パーソナル化テーブル、ビュー、および関連するストアド プロシージャをインストールします。

• uninstallpagepersonalization.sql - パーソナル化テーブル、ビュー、および関連するストアド プロシージャをアンインストールします。

Web アプリケーションが既定の信頼レベル Medium 以上で実行されていない場合は、パーソナル化が失敗します (要素を使用して <trust level="" /> 、Web.config ファイルでカスタム信頼レベルを設定できます)。 クラスと SqlPersonalizationProvider クラスはPersonalizationAdministrationどちらも、初期化時に のLow信頼レベルを確認します。 信頼レベル で実行するようにアプリケーションを構成し、既定SqlPersonalizationProviderのLowプロバイダーを使用してアプリケーションのパーソナル化データを管理する場合、アプリケーションが初めてパーソナル化データにアクセスしようとすると、信頼で実行されている Low ASP.NET ワーカー プロセスに名前空間のさまざまなクラスSystem.Data.SqlClientを呼び出すために必要なアクセス許可がないため、失敗します。

コンストラクター

SqlPersonalizationProvider()

SqlPersonalizationProvider クラスの新しいインスタンスを初期化します。

プロパティ

ApplicationName	パーソナル化情報を格納および取得するアプリケーションの名前を取得または設定します。
Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase)
Name	構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase)

メソッド

CreateSupportedUserCapabilities()	Web パーツ コントロール セットによって使用される一連の既知の機能を表す WebPartUserCapability オブジェクトのリストを返します。 (継承元 PersonalizationProvider)
DetermineInitialScope(WebPartManager, PersonalizationState)	初期パーソナル化スコープが、Shared スコープと User スコープのどちらであるかを判断します。 (継承元 PersonalizationProvider)
DetermineUserCapabilities(WebPartManager)	現在実行中のユーザー アカウントのパーソナル化関連機能を表す WebPartUserCapability のインスタンスが含まれているディクショナリを返します。 (継承元 PersonalizationProvider)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	指定したスコープおよびパラメーターに基づいて、0 個以上の 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 パーツの個人用設定の概要
• チュートリアル: ユーザー コントロールを使用した Web パーツの個人用設定の実装
• Web パーツの個人用設定