PersonalizationProvider.ResetUserState(String, DateTime) メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

派生クラス内でオーバーライドされると、指定したパラメーターに基づいて、Web パーツ パーソナル化データが基になるデータ ストアから削除されます。

public:
 abstract int ResetUserState(System::String ^ path, DateTime userInactiveSinceDate);

public abstract int ResetUserState (string path, DateTime userInactiveSinceDate);

abstract member ResetUserState : string * DateTime -> int

Public MustOverride Function ResetUserState (path As String, userInactiveSinceDate As DateTime) As Integer

パラメーター

path

String

削除されるパーソナル化データのパス。 この値に null は使用できますが、空の文字列 ("") は使用できません。

userInactiveSinceDate

DateTime

Web サイトのユーザーがパーソナル化データを最後に変更した日付。

戻り値

Int32

基になるデータ ストアから削除された行数。

注釈

このメソッドは、パーソナル化データを削除するための管理メソッドの抽象定義です。 このメソッドは、ユーザーパーソナル化データにのみ影響し、共有データには影響しないことに注意してください。

派生実装は、以下で説明するロジックに従う必要があります。

• パラメーターに path ワイルドカード文字を含めることはできません。

• プロバイダーがトランザクション対応データ ストアからデータを公開する場合、このメソッドは 1 つのアトミック トランザクションでその操作を実行する必要があります。

• パラメーターが path 非nullの場合は、 に関連付けられている path ユーザーごとのパーソナル化レコードのみが削除されます。

• パラメーターに示されている userInactiveSinceDate 日付が削除されるため、非アクティブと見なされるユーザーに関連付けられているユーザーごとのパーソナル化レコードのみが削除されます。 具体的には、 が 以下UserInactiveSinceDateのレコードLastActivityDateは削除されます。

• 両方のパラメーターを指定すると、両方の制約に一致するレコードが削除されます。

• path パラメーターは、null に設定できます。

• パラメーターを path 空の文字列にすることはできません。 このチェックを実行する前にトリミングする必要があります。

• UserInactiveSinceDate プロパティを null にすることはできません。