8.1.5.4 ResetState

このメソッドは、指定されたパラメータに基づいて、基礎となるデータ・ソースからパーソナライズ状態情報を削除します。

宣言

// C#
public override int ResetState(PersonalizationScope scope, string[] paths,
   string[] usernames);

パラメータ

  • scope

    問合せを行うパーソナライズ情報を示すPersonalizationScope型。この値はnull参照にできません。

  • paths

    削除する共有scopeパラメータ内のパーソナライズ情報のパス。

  • usernames

    ユーザーscopeパラメータ内の削除するパーソナライズ情報のユーザー名。

戻り値

削除する行数。

例外

ArgumentOutOfRangeException - 指定されたscopeパラメータは、PersonalizationScope列挙値のメンバーではありません。

OracleException - Oracle関連のエラーが発生しました。

ArgumentException - 次のいずれかの条件が存在します。

  • pathsまたはusernamesパラメータが空の配列です。

  • paths配列またはusernames配列の属性が検証ルールを満たしていません。検証ルールについては、次の「備考」の項を参照してください。

備考

このメソッドは、操作を単一のアトミック・トランザクションとして実行します。

それぞれの配列に含まれるpathsおよびusernames要素は、次の検証ルールを満たす必要があります。検証ルールがパラメータ配列のいずれかのメンバーで失敗した場合は、ArgumentException例外がスローされます。検証ルールは次のとおりです。

  • Null参照値は許可されません。

  • 空の文字列("")は使用できません。空の文字列チェックを実行する前に、パラメータを切り捨てる必要があります。

  • usernames配列にカンマ(,)を含めることはできません。