LinqDataSourceStatusEventArgs.TotalRowCount Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Place le nombre total de lignes dans un groupe de données d'une opération d'extraction de données.

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Valeur de propriété

Int32

Nombre total de lignes dans un groupe de données de l'opération d'extraction de données ; -1 si l'objet LinqDataSourceStatusEventArgs a été créé pendant une opération de modification de données ; -1 si vous avez activé la pagination personnalisée en affectant true à AutoPage et en affectant false à RetrieveTotalRowCount.

Exemples

L’exemple suivant montre une page Web avec un LinqDataSource contrôle, un GridView contrôle et un Literal contrôle. Le LinqDataSource contrôle définit un gestionnaire d’événements pour l’événement 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>

L’exemple suivant montre le code du gestionnaire d’événements pour l’événement Selected . La valeur de la TotalRowCount propriété est affectée au Literal contrôle.

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

Remarques

Vous utilisez la TotalRowCount propriété pour obtenir le nombre d’enregistrements dans le jeu de données lors d’une opération de récupération de données. En règle générale, vous récupérez cette propriété lorsque vous affichez des pages de données et que vous souhaitez afficher le nombre total d’enregistrements.

Lorsque des données sont paginées, la valeur de la TotalRowCount propriété peut être différente du nombre réel de lignes retournées par la requête. En effet, la requête retourne uniquement le nombre de lignes nécessaires pour cette page de données.

La TotalRowCount propriété contient le nombre d’enregistrements d’une requête uniquement lorsqu’elle est accessible dans un gestionnaire d’événements pour l’événement Selected . Lorsque la propriété est accessible à partir d’un gestionnaire d’événements pour l’événement ContextCreated, Deleted, Insertedou , la TotalRowCountUpdated propriété contient -1.

La valeur de la TotalRowCount propriété dépend de la AutoPage propriété du LinqDataSource contrôle et de la AllowPaging propriété du contrôle lié aux données. Le tableau suivant récapitule les valeurs possibles pour la TotalRowCount propriété .

Propriété AutoPage du contrôle LinqDataSource	AllowPaging, propriété du contrôle lié aux données	TotalRowCount, propriété	Résultat
true	true	Nombre d’enregistrements pour une requête.	Les données sont automatiquement paginées.
false	false	Nombre d’enregistrements pour une requête.	Les données ne sont pas paginées.
true	false	-1	Les données ne sont pas paginées.
false	true	Valeur que vous avez attribuée à la TotalRowCount propriété dans le gestionnaire d’événements pour l’événement Selecting .	Les données sont paginées en fonction des valeurs que vous avez spécifiées lorsque vous avez personnalisé la pagination.