Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

FormView.PagerTemplate-Eigenschaft

.NET Framework 3.0

Ruft den benutzerdefinierten Inhalt der Pagerzeile in einem FormView-Steuerelement ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[TemplateContainerAttribute(typeof(FormView))] 
public virtual ITemplate PagerTemplate { get; set; }

/** @property */
public ITemplate get_PagerTemplate ()

/** @property */
public void set_PagerTemplate (ITemplate value)

JScript

public function get PagerTemplate () : ITemplate

public function set PagerTemplate (value : ITemplate)

XAML

Nicht zutreffend.

Eigenschaftenwert

Eine System.Web.UI.ITemplate, die den benutzerdefinierten Inhalt für die Pagerzeile enthält. Der Standardwert ist NULL. Dies bedeutet, dass diese Eigenschaft nicht festgelegt wurde.

Hinweise

In einem FormView-Steuerelement wird eine Pagerzeile angezeigt, wenn das Pagingfeature aktiviert ist (d. h., dass die AllowPaging-Eigenschaft auf TRUE festgelegt ist). Die Pagerzeile enthält die Steuerelemente, die es dem Benutzer ermöglichen, auf die verschiedenen Seiten im Steuerelement zu navigieren. Anstatt die integrierte Benutzeroberfläche der Pagerzeile zu verwenden, können Sie mithilfe der PagerTemplate-Eigenschaft auch eine eigene Benutzeroberfläche definieren.

Hinweis:
Durch Festlegen der PagerTemplate-Eigenschaft wird die integrierte Benutzeroberfläche der Pagerzeile überschrieben.

Zum Angeben einer benutzerdefinierten Vorlage für die Pagerzeile fügen Sie zunächst <PagerTemplate>-Tags zwischen dem öffnenden und dem schließenden Tag des FormView-Steuerelements ein. Anschließend können Sie den Inhalt der Vorlage zwischen den öffnenden und schließenden <PagerTemplate>-Tags auflisten. Verwenden Sie die PagerStyle-Eigenschaft, um die Darstellung der Pagerzeile zu steuern.

In der Regel werden der Pagervorlage Schaltflächensteuerelemente hinzugefügt, mit denen die Pagingvorgänge ausgeführt werden können. Das FormView-Steuerelement führt einen Pagingvorgang aus, wenn auf ein Schaltflächensteuerelement geklickt wird, dessen CommandName-Eigenschaft auf "Page" festgelegt ist. Die CommandArgument-Eigenschaft der Schaltfläche bestimmt den Typ des auszuführenden Pagingvorgangs. In der folgenden Tabelle sind alle vom FormView-Steuerelement unterstützten Befehlsargumentwerte aufgeführt.

CommandArgument-Wert	Beschreibung
"Next"	Navigiert zur nächsten Seite.
"Prev"	Navigiert zur vorherigen Seite.
"First"	Navigiert zur ersten Seite.
"Last"	Navigiert zur letzten Seite.
Ganzzahlwert	Navigiert zur angegebenen Seitenzahl.

Beispiel

Das folgende Beispiel veranschaulicht, wie eine benutzerdefinierte Pagervorlage definiert wird.


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

Plattformen

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0, 2.0

Siehe auch

Referenz

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?

Informationen zur Datensicherheit