8.1.5.2 GetCountOfState
このメソッドは、指定されたスコープ内の基礎となるOracleデータベース内の行数を戻します。
宣言
// C# public override int GetCountOfState(PersonalizationScope scope, PersonalizationStateQuery query);
パラメータ
-
scope
パーソナライズ情報の問合せのスコープ(ユーザーまたは共有)。これはnull参照にできません。
-
query
パーソナライズ情報のフィルタ処理に使用する問合せ。これはnull参照にできます。
戻り値
指定されたスコープ・パラメータ内の基礎となるデータ・ソースの行数。
例外
ArgumentException
- query
のPathToMatch
またはUsernameToMatch
プロパティがnull以外の参照であり、切り捨て後に空の文字列("")になります。
ArgumentOutOfRangeException
- 指定されたスコープは、PersonalizationScope
列挙の有効値ではありません。
OracleException
- Oracle関連のエラーが発生しました。
備考
このメソッドは、問合せワイルドカード文字を基礎となるOracleデータベースに渡します。データベースは、query
パラメータのPathToMatch
プロパティ内の検索文字列テキストの先頭、末尾または途中に出現したワイルドカード文字で部分的なパスのワイルドカード検索を実行します。たとえば、PathToMatch
プロパティを~/appdir%
に設定すると、~/appdir
で始まるすべてのパスが見つかります。
同様に、部分的なユーザー名のワイルドカード検索では、ワイルドカード文字がquery
パラメータのUsernameToMatch
プロパティのテキスト文字列のどのポイントに出現してもかまいません。たとえば、scott
から始まるすべてのユーザー名を検索するには、UsernameToMatch
パラメータはscott%
のようになります
次の問合せ制約に従う必要があります。
-
scope
パラメータのみ指定され、query
パラメータがnull参照であるか、query
パラメータのすべてのプロパティがnull参照またはデフォルト値を戻す場合は、指定されたscope
パラメータに一致するすべてのレコードが戻されます。 -
PathToMatch
プロパティがnull参照でない場合、戻されるレコードでは、PathToMatch
値に一致するパスに基づくフィルタ処理も行われます。 -
UsernameToMatch
プロパティがnull参照でない場合、戻されるレコードでは、UsernameToMatch
プロパティ値に一致するユーザー名に基づくフィルタ処理も行われます。 -
UserInactiveSinceDate
プロパティがMaxValue
と等しくない場合は、戻されるレコードのフィルタ処理も行われ、非アクティブなユーザーに関連付けられているレコードのみ戻されます。比較には、LastActivityDate
プロパティがUserInactiveSinceDate
プロパティ以下であるレコードが含まれます。