RecordsPerRequest プロパティ (GcListBox)

データを動的に読み込むとき、一度に読み込むデータ数を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property RecordsPerRequest As Integer

public int RecordsPerRequest {get; set;}

プロパティ値

既定値：20

例外

例外	解説
System.ArgumentOutOfRangeException	負の値が設定されています。

解説

RecordsPerRequestプロパティは、LoadDataDynamicallyプロパティがTrueの場合に、内部でAjax(Asynchronous JavaScript + XML)を使用しデータを動的に読み込むとき、一度に読み込むデータ数を設定します。

リストをスクロールし、読み込み済みのデータ数を超えると、それ以降のデータがRecordsPerRequestプロパティで設定された数だけ再度読み込まれます。

読み込み済みのデータ数を超えた位置にスクロールされたとき、読み込み前の項目は表示されないため、一瞬リストコントロールがクリアされたような表示になります。
クライアント側スクリプトで、読み込み済みのデータ数を超えた項目の選択や値の取得などの制御を行うと、エラーが発生する場合があります。

参照

GcListBox クラス
 GcListBox メンバ