Sdílet prostřednictvím


LinqDataSourceStatusEventArgs.TotalRowCount Vlastnost

Definice

Získá celkový počet řádků v datové sadě z operace načtení dat.

public:
 property int TotalRowCount { int get(); };
public int TotalRowCount { get; }
member this.TotalRowCount : int
Public ReadOnly Property TotalRowCount As Integer

Hodnota vlastnosti

Celkový počet řádků v datové sadě z operace načtení dat; -1, pokud LinqDataSourceStatusEventArgs byl objekt vytvořen během operace úpravy dat; -1, pokud jste povolili přizpůsobené stránkování nastavením AutoPage na true a nastavením RetrieveTotalRowCount na false.

Příklady

Následující příklad ukazuje webovou stránku s ovládacím prvek LinqDataSource , ovládací prvek GridView a ovládací prvek Literal . Ovládací LinqDataSource prvek definuje obslužnou rutinu Selected události pro událost.

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

Následující příklad ukazuje kód obslužné rutiny události pro Selected událost. Hodnota TotalRowCount vlastnosti je přiřazena ovládacímu prvku Literal .

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

Poznámky

Vlastnost slouží TotalRowCount k získání počtu záznamů v datové sadě během operace načítání dat. Obvykle se tato vlastnost načítá, když zobrazujete stránky dat a chcete zobrazit celkový počet záznamů.

Při stránkování dat se hodnota ve TotalRowCount vlastnosti může lišit od skutečného počtu řádků vrácených dotazem. Důvodem je to, že dotaz vrátí pouze počet řádků potřebných pro danou stránku dat.

Vlastnost TotalRowCount obsahuje počet záznamů z dotazu pouze při přístupu v obslužné rutině události události Selected . Při přístupu k vlastnosti z obslužné rutiny ContextCreatedudálosti události TotalRowCount , Deleted, Insertednebo Updated obsahuje vlastnost -1.

Hodnota TotalRowCount vlastnosti závisí na AutoPage vlastnosti LinqDataSource ovládacího prvku a na AllowPaging vlastnosti ovládacího prvku vázaného na data. Následující tabulka shrnuje možné hodnoty vlastnosti TotalRowCount .

AutoPage – vlastnost ovládacího prvku LinqDataSource AllowPaging – vlastnost ovládacího prvku vázaného na data TotalRowCount – vlastnost Výsledek
true true Počet záznamů pro dotaz Data se automaticky stránkuje.
false false Počet záznamů pro dotaz Data nejsou stránkována.
true false -1 Data nejsou stránkována.
false true Hodnota, kterou jste přiřadili TotalRowCount vlastnosti v obslužné rutině Selecting události události. Data se stránkují podle hodnot, které jste zadali při přizpůsobení stránkování.

Platí pro