PersonalizationAdministration.ResetState メソッド

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

コレクションに含まれる項目に基づいて、基になるデータ ストア内のパーソナル化データをリセットします。

public:
 static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState(System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer

パラメーター

data
PersonalizationStateInfoCollection

リセットする必要があるデータを示す PersonalizationStateInfo オブジェクトのコレクション。

返品

Int32

リセットされた行の数。

例外

ArgumentNullException

data は nullです。

ArgumentException

data は空のコレクションです。

-又は-

コレクションの要素が null。

-又は-

コレクション内の UserPersonalizationStateInfo インスタンスのパス値が null または空の文字列 ("") です。

-又は-

コレクション内のuser インスタンスのUserPersonalizationStateInfo値は、null、空の文字列、またはコンマを含みます。

-又は-

構成で定義されているパーソナル化プロバイダーのプロバイダーが正しい型ではありません。

-又は-

パラメーターの文字列の長さが 256 文字を超えています。

ConfigurationErrorsException

構成済みのパーソナル化プロバイダーのインスタンスを作成および初期化しようとしたときに、構成例外が発生しました。

-又は-

構成で定義されている既定のパーソナル化プロバイダーが見つかりませんでした。

HttpException

既定のプロバイダーは、削除された行の数が負の数であることを示しました。

注釈

このメソッドは、コレクションに含まれる PersonalizationStateInfo オブジェクトに基づいて、基になるデータ ストア内のパーソナル化データをリセットします。 このメソッドを使用すると、コレクションの内容に基づいて、共有データとユーザーごとのデータの組み合わせを選択的に削除できます。 SharedPersonalizationStateInfo オブジェクトは、ページの共有データがリセットされることを示します。 UserPersonalizationStateInfo オブジェクトは、特定のページのユーザーごとのデータがリセットされることを示します。

Note

このメソッドは、コレクションがパーソナル化データのランダム なセットを指しているため、すべてのリセットが 1 つのトランザクション内で発生することを保証するものではありません。

存在しないデータを参照するオブジェクトをコレクションに含めるのはエラーではありません。

適用対象

こちらもご覧ください