Esporta (0) Stampa
Espandi tutto

Proprietà FormView.PagerTemplate

Aggiornamento: novembre 2007

Ottiene o imposta il contenuto personalizzato per la riga di spostamento in un controllo FormView.

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

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(FormView))]
public virtual ITemplate PagerTemplate { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute TemplateContainerAttribute(FormView) */
public ITemplate get_PagerTemplate()
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute TemplateContainerAttribute(FormView) */
public  void set_PagerTemplate(ITemplate value)

public function get PagerTemplate () : ITemplate
public function set PagerTemplate (value : ITemplate)
<asp:FormView>
	<PagerTemplate>ITemplate</PagerTemplate>
</asp:FormView>

Valore proprietà

Tipo: System.Web.UI.ITemplate

Un oggetto System.Web.UI.ITemplate con il contenuto personalizzato per la riga di spostamento. Il valore predefinito è null, a indicare che questa proprietà non è impostata.

In un controllo FormView viene visualizzata una riga di spostamento quando è attivata la funzionalità di spostamento, ossia quando la proprietà AllowPaging è impostata su true. Nella riga di spostamento sono inclusi i controlli che consentono all'utente di spostarsi tra le diverse pagine del controllo. Anziché utilizzare l'interfaccia utente della riga di spostamento incorporata, è possibile definire un'interfaccia utente personalizzata utilizzando la proprietà PagerTemplate.

Nota:

Quando è impostata la proprietà PagerTemplate, viene eseguito l'override dell'interfaccia utente della riga di spostamento incorporata.

Per specificare un modello personalizzato per la riga di spostamento, inserire innanzitutto i tag <PagerTemplate> tra i tag di apertura e chiusura del controllo FormView. È quindi possibile elencare il contenuto del modello inserito tra i tag <PagerTemplate> di apertura e di chiusura. Per definire l'aspetto della riga di spostamento, utilizzare la proprietà PagerStyle.

Al modello di spostamento vengono in genere aggiunti controlli pulsante per l'esecuzione delle operazioni di spostamento. Il controllo FormView esegue un'operazione di spostamento quando viene fatto clic su un controllo pulsante la cui proprietà CommandName è impostata su "Page". La proprietà CommandArgument del pulsante determina il tipo di operazione di spostamento da eseguire. Nella tabella riportata di seguito sono elencati i valori CommandArgument supportati dal controllo FormView.

Valore CommandArgument

Descrizione

"Next"

Passa alla pagina successiva.

"Prev"

Passa alla pagina precedente.

"First"

Passa alla prima pagina.

"Last"

Passa all'ultima pagina.

Valore integer

Passa al numero di pagina specificato.

Nell'esempio riportato di seguito viene illustrato come definire un modello di spostamento personalizzato.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void EmployeeFormView_DataBound(Object sender, EventArgs e)
  {

    // Get the pager row.
    FormViewRow pagerRow = EmployeeFormView.BottomPagerRow;

    // 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 = EmployeeFormView.PageIndex + 1;
      int count = EmployeeFormView.PageCount;

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

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView PagerTemplate Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>FormView PagerTemplate Example</h3>

      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        ondatabound="EmployeeFormView_DataBound" 
        runat="server">

        <itemtemplate>
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>    
        </itemtemplate>

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

        <pagersettings position="Bottom"
          mode="NextPrevious"/> 

      </asp:formview>

      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

    </form>
  </body>
</html>



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

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

.NET Framework

Supportato in: 3.5, 3.0, 2.0

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft