Interstage Shunsaku Data Manager アプリケーション開発ガイド - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX共通 -

10.3.2.4 ヒット件数の上限値を設定する

ヒット件数の上限値を設定することで、ソートまたは集計の応答性能を安定させることができます。ヒット件数が上限値を超えた場合には、ソートまたは集計を中断し検索条件に一致したヒット件数を通知します。

ヒット件数が上限値を超えないように検索式に条件を追加し、ソートまたは集計の検索範囲を絞り込みます。

ヒット件数の上限値を設定するには、HitCountLimitプロパティを使用します。

ヒット件数の上限値を設定する場合の流れについて、以下の図に示します。

[図: ヒット件数の上限値を設定する場合の流れ]

■記述例

ShunService service = new ShunService();
service.Connect();

ShunSearchRequirement req = new ShunSearchRequirement();
req.QueryExpression = "/document/base/prefecture == '大阪'";
req.ReturnExpression = "/document/base/name, /document/base/price";
req.SortExpression = "val(/document/base/price/text()) DESC";
req.HitCountLimit = 10000;                                                     (1)

ShunResultSet rs = service.Search( req );
if ( rs.IsHitCountLimitOver ) {                                                (2)
  Console.WriteLine ("ヒット件数が上限を超えました");
  Console.WriteLine ("[ヒット件数] = " + rs.HitCount);                          (3)
}
else{
  Console.WriteLine("[ヒット件数] = " + rs.HitCount);
  int i = 0; 
  foreach ( ShunRecord record in rs.Records ) {
    ++i; 
    Console.WriteLine( "[結果] {0}件目 = {1}", i, record.Data );
  }
}

service.Disconnect();

◆(1) ヒット件数の上限値設定

HitCountLimitプロパティのパラメタにヒット件数の上限値を設定します。

ソート式が設定されていない場合には、Searchメソッド実行時にエラーとなります。

◆(2) ヒット件数が上限値を超えているの確認

IsHitCountLimitOverプロパティでヒット件数が上限値を超えているかの確認をします。

◆(3) ヒット件数の取出し

ヒット件数が上限値を超えている場合は、ヒット件数のみ取出し可能です。