LinqDataSourceStatusEventArgs.TotalRowCount Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

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

Int32

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