LinqDataSourceStatusEventArgs.TotalRowCount 属性

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.Extensions.dll

获取数据检索操作过程中在某个数据集中检索的总行数。

public:
 property int TotalRowCount { int get(); };

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

属性值

Int32

数据检索操作过程中在某个数据集中检索的总行数；如果 LinqDataSourceStatusEventArgs 对象是在数据修改操作过程中创建的，则为 -1；如果通过将 AutoPage 设置为 true 并将 RetrieveTotalRowCount 设置为 false 启用了自定义分页，则为 -1。

示例

以下示例演示一个包含 LinqDataSource 控件、 GridView 控件和 控件的 Literal 网页。 控件 LinqDataSource 为 Selected 事件定义事件处理程序。

<asp:Literal ID="Literal1" runat="server"></asp:Literal> Total Records
<br />
<asp:LinqDataSource 
  AutoPage="true"
  ID="LinqDataSource1" 
  runat="server" 
  ContextTypeName="ExampleDataContext" 
  TableName="Customers" 
  onselected="LinqDataSource1_Selected">
</asp:LinqDataSource>
<asp:GridView 
  ID="GridView1" 
  runat="server" 
  AllowPaging="true" 
  AutoGenerateColumns="True" 
  DataKeyNames="CustomerID" 
  DataSourceID="LinqDataSource1">
</asp:GridView>

<asp:Literal ID="Literal1" runat="server"></asp:Literal> Total Records
<br />
<asp:LinqDataSource 
  AutoPage="true"
  ID="LinqDataSource1" 
  runat="server" 
  ContextTypeName="ExampleDataContext" 
  TableName="Customers">
</asp:LinqDataSource>
<asp:GridView 
  ID="GridView1" 
  runat="server" 
  AllowPaging="true" 
  AutoGenerateColumns="True" 
  DataKeyNames="CustomerID" 
  DataSourceID="LinqDataSource1">
</asp:GridView>

以下示例显示了 事件的事件处理程序 Selected 的代码。 属性的值 TotalRowCount 分配给 Literal 控件。

protected void LinqDataSource1_Selected(object sender, LinqDataSourceStatusEventArgs e)
{
    Literal1.Text = e.TotalRowCount.ToString();
}

Protected Sub LinqDataSource1_Selected(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceStatusEventArgs) Handles LinqDataSource1.Selected
    Literal1.Text = e.TotalRowCount.ToString()
End Sub

注解

在数据检索操作期间， TotalRowCount 使用 属性获取数据集中的记录数。 通常，在显示数据页并希望显示记录总数时检索此属性。

对数据进行分页时， 属性中的 TotalRowCount 值可能与查询返回的实际行数不同。 这是因为查询仅返回该数据页所需的行数。

仅当在事件的事件处理程序Selected中访问查询时， 属性TotalRowCount才包含查询中的记录数。 从 、、 或 事件的事件处理程序ContextCreated访问 属性时， TotalRowCount 属性包含 -1。UpdatedInsertedDeleted

属性的值TotalRowCount取决于 控件的 LinqDataSource 属性，以及AllowPaging数据绑定AutoPage控件的 属性。 下表汇总了 属性的可能值 TotalRowCount 。

LinqDataSource 控件的 AutoPage 属性	数据绑定控件的 AllowPaging 属性	TotalRowCount 属性	业务成效
true	true	查询的记录数。	数据会自动分页。
false	false	查询的记录数。	数据不分页。
true	false	-1	数据不分页。
false	true	在 事件的事件处理程序中分配给 TotalRowCount 属性的值 Selecting 。	数据根据自定义分页时指定的值进行分页。