LinqDataSourceStatusEventArgs.TotalRowCount Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Extensions.dll

Pobiera łączną liczbę wierszy w zestawie danych z operacji pobierania danych.

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Wartość właściwości

Int32

Całkowita liczba wierszy w zestawie danych z operacji pobierania danych; -1, jeśli obiekt został utworzony podczas operacji modyfikacji danych; -1, jeśli LinqDataSourceStatusEventArgs włączono dostosowywanie stronicowania, ustawiając wartość i przez ustawienie AutoPagetrue na RetrieveTotalRowCountfalse.

Przykłady

Poniższy przykład przedstawia stronę sieci Web z kontrolką LinqDataSource , GridView kontrolką i kontrolką Literal . Kontrolka LinqDataSource definiuje procedurę obsługi zdarzeń Selected dla zdarzenia.

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

Poniższy przykład przedstawia kod programu obsługi zdarzeń dla Selected zdarzenia. Wartość TotalRowCount właściwości jest przypisywana do kontrolki 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

Uwagi

Właściwość służy TotalRowCount do pobierania liczby rekordów w zestawie danych podczas operacji pobierania danych. Zazwyczaj pobierasz tę właściwość podczas wyświetlania stron danych i chcesz wyświetlić łączną liczbę rekordów.

Gdy dane są stronicowane, wartość właściwości TotalRowCount może być inna niż rzeczywista liczba wierszy zwracanych przez zapytanie. Jest to spowodowane tym, że zapytanie zwraca tylko liczbę wierszy, które są potrzebne dla tej strony danych.

Właściwość TotalRowCount zawiera liczbę rekordów z zapytania tylko wtedy, gdy jest ona dostępna w procedurze obsługi zdarzeń Selected dla zdarzenia. Gdy właściwość jest uzyskiwana z programu obsługi zdarzeń dla ContextCreatedzdarzenia , , DeletedInsertedlub Updated zdarzenia, TotalRowCount właściwość zawiera -1.

Wartość TotalRowCount właściwości zależy od AutoPage właściwości LinqDataSource kontrolki i właściwości AllowPaging kontrolki powiązanej z danymi. Poniższa tabela zawiera podsumowanie możliwych wartości właściwości TotalRowCount .

Właściwość AutoPage kontrolki LinqDataSource	AllowPaging Właściwość kontrolki powiązanej z danymi	Właściwość TotalRowCount	Wynik
true	true	Liczba rekordów dla zapytania.	Dane są automatycznie stronicowane.
false	false	Liczba rekordów dla zapytania.	Dane nie są stronicowane.
true	false	-1	Dane nie są stronicowane.
false	true	Wartość przypisana TotalRowCount do właściwości w procedurze obsługi zdarzeń Selecting dla zdarzenia.	Dane są stronicowane zgodnie z wartościami określonymi podczas dostosowywania stronicowania.