Freigeben über


LinqDataSourceStatusEventArgs.TotalRowCount Eigenschaft

Definition

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

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.

Gilt für: