LinqDataSourceStatusEventArgs.TotalRowCount Eigenschap

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

public int TotalRowCount { get; }

member this.TotalRowCount : int

Public ReadOnly Property TotalRowCount As Integer

Waarde van eigenschap

Het totale aantal rijen in een gegevensset van de bewerking voor het ophalen van gegevens; -1 of het LinqDataSourceStatusEventArgs object is gemaakt tijdens een bewerking voor het wijzigen van gegevens; -1 als u aangepaste paging hebt ingeschakeld door het instellen AutoPage op true en door in te stellen RetrieveTotalRowCount op false.

Voorbeelden

In het volgende voorbeeld ziet u een webpagina met een LinqDataSource besturingselement, een GridView besturingselement en een Literal besturingselement. Het LinqDataSource besturingselement definieert een gebeurtenis-handler voor de Selected gebeurtenis.

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

In het volgende voorbeeld ziet u de code voor de gebeurtenis-handler voor de Selected gebeurtenis. De waarde van de TotalRowCount eigenschap wordt toegewezen aan het Literal besturingselement.

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

Opmerkingen

U gebruikt de TotalRowCount eigenschap om het aantal records in de gegevensset op te halen tijdens een bewerking voor het ophalen van gegevens. Normaal gesproken haalt u deze eigenschap op wanneer u pagina's met gegevens weergeeft en het totale aantal records wilt weergeven.

Wanneer gegevens worden gepaginad, kan de waarde in de TotalRowCount eigenschap afwijken van het werkelijke aantal rijen dat door de query wordt geretourneerd. Dit komt doordat de query alleen het aantal rijen retourneert dat nodig is voor die pagina met gegevens.

De TotalRowCount eigenschap bevat alleen het aantal records uit een query wanneer deze wordt geopend in een gebeurtenis-handler voor de Selected gebeurtenis. Wanneer de eigenschap wordt geopend vanuit een gebeurtenis-handler voor de ContextCreatedDeleted, of InsertedUpdated gebeurtenis, bevat de TotalRowCount eigenschap -1.

De waarde van de TotalRowCount eigenschap is afhankelijk van de AutoPage eigenschap van het LinqDataSource besturingselement en van de AllowPaging eigenschap van het gegevensgebonden besturingselement. De volgende tabel bevat een overzicht van de mogelijke waarden voor de TotalRowCount eigenschap.