LinqDataSourceStatusEventArgs.TotalRowCount Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém o número total de linhas em um conjunto de dados de uma operação de recuperação de dados.

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Valor da propriedade

Int32

O número total de linhas em um 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 você habilitou a paginação personalizada definindo AutoPage como true e definindo como RetrieveTotalRowCountfalse.

Exemplos

O exemplo a seguir mostra uma página da Web com um LinqDataSource controle, um GridView controle e um Literal controle . O LinqDataSource controle define um manipulador 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 a seguir mostra o código para o manipulador de eventos do Selected evento. O valor da TotalRowCount propriedade é atribuído ao Literal controle .

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

Comentários

Você usa a TotalRowCount propriedade para obter o número de registros no conjunto de dados durante uma operação de recuperação de dados. Normalmente, você recupera essa propriedade quando está exibindo páginas de dados e deseja mostrar o número total de registros.

Quando os dados estão sendo paginado, o valor na TotalRowCount propriedade pode ser diferente do número real de linhas retornadas pela consulta. Isso ocorre porque a consulta retorna apenas o número de linhas necessárias para essa página de dados.

A TotalRowCount propriedade contém o número de registros de uma consulta somente quando ela é acessada em um manipulador de eventos para o Selected evento. Quando a propriedade é acessada de um manipulador de eventos para o ContextCreatedevento , Deleted, Insertedou Updated , a TotalRowCount propriedade contém -1.

O valor da TotalRowCount propriedade depende da AutoPage propriedade do LinqDataSource controle e da AllowPaging propriedade do controle associado a dados. A tabela a seguir resume os valores possíveis para a TotalRowCount propriedade .

Propriedade AutoPage do controle LinqDataSource	Propriedade AllowPaging do controle associado a dados	Propriedade TotalRowCount	Resultado
true	true	Número de registros para uma consulta.	Os dados são paginado automaticamente.
false	false	Número de registros para uma consulta.	Os dados não são paginado.
true	false	-1	Os dados não são paginado.
false	true	O valor que você atribuiu à TotalRowCount propriedade no manipulador de eventos para o Selecting evento.	Os dados são paginados de acordo com os valores especificados ao personalizar a paginação.