LinqDataSourceStatusEventArgs.TotalRowCount Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft die Gesamtanzahl der Zeilen in einem Dataset für einen Datenabrufvorgang ab.

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Eigenschaftswert

Int32

Die Gesamtanzahl der Zeilen in einem Dataset für einen Datenabrufvorgang: -1, wenn das LinqDataSourceStatusEventArgs-Objekt während eines Datenänderungsvorgangs erstellt wurde; -1, wenn Sie benutzerdefiniertes Paging durch Festlegen von AutoPage auf true und RetrieveTotalRowCount auf false aktiviert haben.

Beispiele

Das folgende Beispiel zeigt eine Webseite mit einem LinqDataSource Steuerelement, einem GridView Steuerelement und einem Literal Steuerelement. Das LinqDataSource Steuerelement definiert einen Ereignishandler für das Selected Ereignis.

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

Das folgende Beispiel zeigt den Code für den Ereignishandler für das Selected Ereignis. Der Wert der TotalRowCount -Eigenschaft wird dem Literal Steuerelement zugewiesen.

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

Hinweise

Sie verwenden die TotalRowCount -Eigenschaft, um die Anzahl der Datensätze im Dataset während eines Datenabrufvorgangs abzurufen. In der Regel rufen Sie diese Eigenschaft ab, wenn Sie Datenseiten anzeigen und die Gesamtzahl der Datensätze anzeigen möchten.

Wenn Daten ausgelagert werden, kann sich der Wert in der TotalRowCount Eigenschaft von der tatsächlichen Anzahl von Zeilen unterscheiden, die von der Abfrage zurückgegeben werden. Dies liegt daran, dass die Abfrage nur die Anzahl der Zeilen zurückgibt, die für diese Datenseite benötigt werden.

Die TotalRowCount -Eigenschaft enthält die Anzahl der Datensätze aus einer Abfrage nur, wenn in einem Ereignishandler für das Selected Ereignis darauf zugegriffen wird. Wenn über einen Ereignishandler für das - , - InsertedDeletedoder Updated -Ereignis auf die ContextCreated-Eigenschaft zugegriffen wird, enthält die TotalRowCount -1-Eigenschaft.

Der Wert der TotalRowCount Eigenschaft hängt von der AutoPage Eigenschaft des LinqDataSource Steuerelements und von der AllowPaging Eigenschaft des datengebundenen Steuerelements ab. In der folgenden Tabelle sind die möglichen Werte für die TotalRowCount -Eigenschaft zusammengefasst.

AutoPage-Eigenschaft des LinqDataSource-Steuerelements	AllowPaging-Eigenschaft des datengebundenen Steuerelements	TotalRowCount-Eigenschaft	Ergebnis
true	true	Anzahl der Datensätze für eine Abfrage.	Daten werden automatisch ausgelagert.
false	false	Anzahl der Datensätze für eine Abfrage.	Daten werden nicht ausgelagert.
true	false	-1	Daten werden nicht ausgelagert.
false	true	Der Wert, den Sie der TotalRowCount Eigenschaft im Ereignishandler für das Selecting Ereignis zugewiesen haben.	Die Daten werden entsprechend den Werten ausgelagert, die Sie beim Anpassen des Pagings angegeben haben.