LinqDataSourceStatusEventArgs.TotalRowCount Propriedade

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Valor de Propriedade

O número total de linhas num conjunto de dados da operação de recuperação de dados; -1 se o LinqDataSourceStatusEventArgs objeto foi criado durante uma operação de modificação de dados; -1 se ativaste a paginação personalizada definindo AutoPage para true e definindo RetrieveTotalRowCount para false.

Exemplos

O exemplo seguinte mostra uma página Web com um LinqDataSource controlo, um GridView controlo e um Literal controlo. O LinqDataSource controlo define um gestor de eventos para o Selected evento.

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

O exemplo seguinte mostra o código do gestor de eventos do Selected evento. O valor da TotalRowCount propriedade é atribuído ao Literal controlo.

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

Observações

Utiliza-se a TotalRowCount propriedade para obter o número de registos no conjunto de dados durante uma operação de recuperação de dados. Normalmente, recupera esta propriedade quando está a mostrar páginas de dados e quer mostrar o número total de registos.

Quando os dados estão a ser paginados, o valor na TotalRowCount propriedade pode ser diferente do número real de linhas que são devolvidas pela consulta. Isto porque a consulta devolve apenas o número de linhas necessárias para essa página de dados.

A TotalRowCount propriedade contém o número de registos de uma consulta apenas quando é acedida num gestor de eventos para o Selected evento. Quando a propriedade é acedida a partir de um gestor de eventos para o ContextCreated, Deleted, Inserted, ou Updated evento, a TotalRowCount propriedade contém -1.

O valor da TotalRowCount propriedade depende da AutoPage propriedade do LinqDataSource controlo e da AllowPaging propriedade do controlo limitado pelos dados. A tabela seguinte resume os valores possíveis da TotalRowCount propriedade.