DataSourceSelectArguments.MaximumRows 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置一个值，该值表示在一次数据检索操作中，数据源控件返回的最大数据行数。

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

在一次数据检索操作中，数据源返回的最大数据行数。默认值为 0，指示返回所有可能的数据行。

MaximumRows属性支持分页方案。数据绑定控件在运行时检查数据源视图的 CanPage 属性， DataSourceCapabilities.Page AddSupportedCapabilities(DataSourceCapabilities) 如果视图支持分页，则使用方法添加功能。如果数据绑定控件未能添加功能，并且在 DataSourceSelectArguments 数据检索操作过程中在传递到数据源视图的对象上设置分页属性，则 InvalidOperationException 可能会引发异常。

数据绑定控件可以通过设置 StartRowIndex MaximumRows DataSourceSelectArguments 传递给方法的对象的和属性，请求数据源控件中的数据子集进行分页 Select(DataSourceSelectArguments, DataSourceViewSelectCallback) 。

重要

如果设置了任何 DataSourceSelectArguments 属性，但当前绑定的数据源控件不支持所请求的功能，则 InvalidOperationException 调用方法时将引发异常 DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) 。