DataSourceSelectArguments.MaximumRows プロパティ

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

データ取得操作でデータ ソース コントロールが返すデータ行の最大数を表す値を取得または設定します。

public:
 property int MaximumRows { int get(); void set(int value); };
public int MaximumRows { get; set; }
member this.MaximumRows : int with get, set
Public Property MaximumRows As Integer

プロパティ値

Int32

データ取得操作でデータ ソースから返されるデータ行の最大数。 既定値は 0 で、使用可能なすべてのデータ行が返されることを示します。

注釈

MaximumRows プロパティはページング シナリオをサポートします。 データ バインド コントロールは、実行時にデータ ソース ビューの CanPage プロパティをチェックし、ビューがページングをサポートしている場合は、DataSourceCapabilities.Page メソッドを使用してAddSupportedCapabilities(DataSourceCapabilities)機能を追加します。 データ バインド コントロールが機能の追加に失敗し、データ取得操作中にデータ ソース ビューに渡された DataSourceSelectArguments オブジェクトにページング プロパティが設定されている場合は、 InvalidOperationException 例外がスローされる可能性があります。

データ バインド コントロールは、StartRowIndex メソッドに渡されるMaximumRows オブジェクトにDataSourceSelectArgumentsプロパティとSelect(DataSourceSelectArguments, DataSourceViewSelectCallback)プロパティを設定することで、ページングのためにデータ ソース コントロールからデータのサブセットを要求できます。

Important

DataSourceSelectArgumentsプロパティのいずれかが設定されていても、現在バインドされているデータ ソース コントロールが要求された機能をサポートしていない場合は、InvalidOperationException メソッドが呼び出されたときにDataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView)例外がスローされます。

適用対象

こちらもご覧ください