LinqDataSourceStatusEventArgs.TotalRowCount Egenskap

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Egenskapsvärde

Det totala antalet rader i en datauppsättning från datahämtningsåtgärden. -1 om LinqDataSourceStatusEventArgs objektet skapades under en dataändringsåtgärd. -1 om du har aktiverat anpassad växling genom att ange AutoPage till true och efter inställning RetrieveTotalRowCount till false.

Exempel

I följande exempel visas en webbsida med en LinqDataSource kontroll, en GridView kontroll och en Literal kontroll. Kontrollen LinqDataSource definierar en händelsehanterare för Selected händelsen.

<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>

I följande exempel visas koden för händelsehanteraren för Selected händelsen. Värdet för TotalRowCount egenskapen tilldelas till Literal kontrollen.

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

Kommentarer

Du använder TotalRowCount egenskapen för att hämta antalet poster i datauppsättningen under en datahämtningsåtgärd. Vanligtvis hämtar du den här egenskapen när du visar sidor med data och vill visa det totala antalet poster.

När data bläddras kan värdet i TotalRowCount egenskapen skilja sig från det faktiska antalet rader som returneras av frågan. Det beror på att frågan endast returnerar det antal rader som behövs för den sidan med data.

Egenskapen TotalRowCount innehåller endast antalet poster från en fråga när den används i en händelsehanterare för Selected händelsen. När egenskapen nås från en händelsehanterare för ContextCreatedhändelsen , Deleted, Insertedeller Updated innehåller TotalRowCount egenskapen -1.

Värdet för TotalRowCount egenskapen beror på AutoPage kontrollens LinqDataSource egenskap och på egenskapen för AllowPaging den databundna kontrollen. I följande tabell sammanfattas de möjliga värdena för TotalRowCount egenskapen.