Esporta (0) Stampa
Espandi tutto

Proprietà DetailsView.TopPagerRow

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene un oggetto DetailsViewRow che rappresenta la riga di spostamento superiore in un controllo DetailsView.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public virtual DetailsViewRow TopPagerRow { get; }
/** @property */
public DetailsViewRow get_TopPagerRow ()

public function get TopPagerRow () : DetailsViewRow

Valore proprietà

Oggetto DetailsViewRow che rappresenta la riga di spostamento superiore nel controllo DetailsView.

Quando la funzionalità di spostamento è attivata, ossia quando la proprietà AllowPaging è impostata su true, nel controllo DetailsView viene visualizzata automaticamente una riga aggiuntiva denominata riga di spostamento. La riga di spostamento contiene controlli che consentono all'utente di spostarsi su altri record e può essere visualizzata nella parte superiore, inferiore o in entrambe le parti del controllo. Utilizzare la proprietà TopPagerRow per accedere a livello di codice all'oggetto DetailsViewRow che rappresenta la riga di spostamento superiore nel controllo DetailsView.

NotaNota

La proprietà TopPagerRow è disponibile solo dopo che il controllo DetailsView ha creato la riga di spostamento inferiore nell'evento ItemCreated.

Questa proprietà viene in genere utilizzata per modificare a livello di codice la riga di spostamento superiore, ad esempio per aggiungere contenuto personalizzato. Qualsiasi modifica relativa alla proprietà TopPagerRow dovrà essere apportata dopo il rendering del controllo DetailsView, altrimenti il controllo DetailsView sovrascriverà le eventuali modifiche apportate.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà TopPagerRow per accedere alla riga di spostamento superiore del controllo DetailsView durante l'evento ItemCreated. Due controlli Label nella riga di spostamento personalizzata vengono quindi aggiornati con il numero di pagina corrente e il numero totale di pagine.


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

<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();
        }

    }
</script>

<html>

  <body>
    <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"
          datasourceid="DetailsViewSource"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server" OnDataBound="CustomerDetailView_DataBound">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
            
          <PagerSettings Position=top /> 
          
          <pagertemplate>
            <table width="100%">
              <tr>
                <td>
                  <asp:LinkButton id="PreviousButton"
                    text="<"
                    CommandName="Page"
                    CommandArgument="Prev"
                    runat="Server"/>
                  <asp:LinkButton id="NextButton"
                    text=">"
                    CommandName="Page"
                    CommandArgument="Next"
                    runat="Server"/> 
                </td>
                <td align="right">                
                  Page <asp:Label id="PageNumberLabel" runat="server"/> 
                  of <asp:Label id="TotalPagesLabel" runat="server"/>                
                </td>
              </tr>
            </table>          
          </pagertemplate>   
                    
        </asp:detailsview>
        <!-- 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" 
          ConnectionString=
            "<%$ 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 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft