LinqDataSourceStatusEventArgs.TotalRowCount Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene el número total de filas de un conjunto de datos en una operación de recuperación de datos.

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Valor de propiedad

Int32

Número total de filas de un conjunto de datos procedente de la operación de recuperación de datos; es -1 si el objeto LinqDataSourceStatusEventArgs se creó durante una operación de modificación de datos; es -1 si se habilitó la paginación personalizada al establecer AutoPage en true y RetrieveTotalRowCount en false.

Ejemplos

En el ejemplo siguiente se muestra una página web con un LinqDataSource control, un GridView control y un Literal control . El LinqDataSource control define un controlador de eventos para el 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>

En el ejemplo siguiente se muestra el código del controlador de eventos para el Selected evento. El valor de la TotalRowCount propiedad se asigna al Literal control .

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

Comentarios

La propiedad se usa TotalRowCount para obtener el número de registros del conjunto de datos durante una operación de recuperación de datos. Normalmente, esta propiedad se recupera cuando se muestran páginas de datos y se desea mostrar el número total de registros.

Cuando se paginan los datos, el valor de la TotalRowCount propiedad puede ser diferente del número real de filas que devuelve la consulta. Esto se debe a que la consulta devuelve solo el número de filas necesarias para esa página de datos.

La TotalRowCount propiedad contiene el número de registros de una consulta solo cuando se accede a ella en un controlador de eventos para el Selected evento. Cuando se obtiene acceso a la propiedad desde un controlador de eventos para el ContextCreatedevento , Deleted, Insertedo Updated , la TotalRowCount propiedad contiene -1.

El valor de la TotalRowCount propiedad depende de la AutoPage propiedad del LinqDataSource control y de la AllowPaging propiedad del control enlazado a datos. En la tabla siguiente se resumen los valores posibles de la TotalRowCount propiedad .

Propiedad AutoPage del control LinqDataSource	AllowPaging (propiedad) del control enlazado a datos	Propiedad TotalRowCount	Resultado
true	true	Número de registros de una consulta.	Los datos se paginan automáticamente.
false	false	Número de registros de una consulta.	Los datos no se paginan.
true	false	-1	Los datos no se paginan.
false	true	Valor que asignó a la TotalRowCount propiedad en el controlador de eventos para el Selecting evento.	Los datos se paginan según los valores que especificó al personalizar la paginación.