This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
This documentation is archived and is not being maintained.

DetailsView.TopPagerRow الخاصية

Visual Studio 2010

تحصل على DetailsViewRowالكائن الذي يمثل تذييل الصفحة الصف في DetailsViewعنصر التحكم.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public virtual DetailsViewRow TopPagerRow { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.DetailsViewRow
DetailsViewRow الذي يمثل الصف العلوي النداء في DetailsViewعنصر تحكم.

When paging is enabled (by setting the AllowPaging property to true), an additional row called the pager row is automatically displayed in the DetailsView control. يحتوي الصف النداء عنصر تحكم s التي تسمح للمستخدم التنقل إلى السجلات الأخرى، ويمكن أن يتم عرضها في الأعلى، الأسفل، أو كل من أعلى وأسفل عنصر تحكم. استخدام TopPagerRowالخصائص للوصول برمجياً DetailsViewRowالكائن الذي يمثل الصف العلوي النداء في DetailsViewعنصر تحكم.


TopPagerRow خاصية هو متوفراً فقط بعد DetailsViewالصف السفلي النداء في يقوم بإنشاء عنصر تحكم ItemCreatedحدث.

Th هو خاصية هو شائعة الاستخدام عند الحاجة لمعالجة صف النداء العلوي، على سبيل المثال عند إضافة محتوى مخصص برمجياً. Any modification to the TopPagerRow property must be performed after the DetailsView control has been rendered; otherwise, the DetailsView control will overwrite any changes.

مثال التعليمة البرمجية التالية يوضح كيفية استخدام TopPagerRowخاصية الوصول إلى تذييل الصفحة صف DetailsViewالتحكم أثناء ItemCreatedحدث. يؤدي النقر فوق إلغاء الأمر في زر abandons أية تغييرات القيمة وإرجاع التحكم إلى الوضع الافتراضي.Label

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">

    protected void CustomerDetailView_DataBound(object sender, EventArgs e)

        // Get the pager row.
        DetailsViewRow pagerRow = CustomerDetailView.TopPagerRow;

        // Get the Label controls that display the current page information 
        // from the pager row.
        Label pageNum = (Label)pagerRow.Cells[0].FindControl("PageNumberLabel");
        Label totalNum = (Label)pagerRow.Cells[0].FindControl("TotalPagesLabel");

        if ((pageNum != null) && (totalNum != null))
            // Update the Label controls with the current page values.
            int page = CustomerDetailView.DataItemIndex + 1;
            int count = CustomerDetailView.DataItemCount;

            pageNum.Text = page.ToString();
            totalNum.Text = count.ToString();


<html xmlns="" >

  <head runat="server">
    <title>DetailsView TopPagerRow Example</title>
    <form id="Form1" runat="server">

      <h3>DetailsView TopPagerRow Example</h3>

        <!-- Notice that the LinkButton controls in the pager   -->
        <!-- template have their CommandName properties set.    -->
        <!-- The DetailsView control automatically recognizes   -->
        <!-- certain command names and performs the appropriate -->
        <!-- operation. In this example, the CommandName        -->
        <!-- properties are set to "Next" and "Prev", which     -->
        <!-- causes the DetailsView control to navigate to the  -->
        <!-- next and previous record, respectively.            -->        
        <asp:detailsview id="CustomerDetailView"
          runat="server" OnDataBound="CustomerDetailView_DataBound">

          <fieldheaderstyle backcolor="Navy"

          <PagerSettings Position="top" /> 

            <table width="100%">
                  <asp:LinkButton id="PreviousButton"
                  <asp:LinkButton id="NextButton"
                <td align="right">                
                  Page <asp:Label id="PageNumberLabel" runat="server"/> 
                  of <asp:Label id="TotalPagesLabel" runat="server"/>                

        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0