DataPagerField Klasse

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Dient als Basisklasse für Datenpager-Feldtypen, die ein Navigationssteuerelement für das DataPager-Steuerelement darstellen.

public ref class DataPagerField abstract : System::Web::UI::IStateManager
public abstract class DataPagerField : System.Web.UI.IStateManager
type DataPagerField = class
    interface IStateManager
Public MustInherit Class DataPagerField
Implements IStateManager
Vererbung
Object
DataPagerField
Abgeleitet
Implementiert
IStateManager

Beispiele

Das folgende Beispiel zeigt, wie Sie NextPreviousPagerField- , NumericPagerField- und TemplatePagerField -Objekte verwenden, um Seitennavigationssteuerelemente in einem DataPager Steuerelement anzuzeigen. Die -Objekte werden von der DataPagerField -Klasse abgeleitet.

<%@ Page language="C#" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" />
            </b>
            <br /><br />
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

<%@ Page language="VB" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# IIf(Container.TotalRowCount>0, (Container.StartRowIndex / Container.PageSize) + 1, 0) %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling (System.Convert.ToDouble(Container.TotalRowCount) / Container.PageSize) %>" />
            </b>
            <br /><br />            
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Hinweise

Die DataPagerField -Klasse dient als Basisklasse für alle Daten-Pager-Feldtypen. Datenblattfelder werden vom DataPager Steuerelement verwendet, um ein Navigationssteuerelement darzustellen.

Verwenden Sie die Klassen, die von DataPagerField abgeleitet werden, um auszuwählen, welcher Pagertyp im DataPager Steuerelement angezeigt wird. In der folgenden Tabelle sind die verfügbaren Daten-Pager-Feldtypen aufgeführt.

Pagerfeldtyp BESCHREIBUNG
NextPreviousPagerField Ermöglicht Es Benutzern, seite für Seite durch Datenseiten zu navigieren oder zur ersten oder letzten Seite zu springen.
NumericPagerField Ermöglicht Benutzern die Auswahl einer Seite nach Seitenzahl.
TemplatePagerField Ermöglicht Seitenentwicklern das Erstellen einer benutzerdefinierten Paging-Benutzeroberfläche.

Sie können von der DataPagerField -Klasse ableiten, um zusätzliche Pagerfeldtypen zu erstellen.

Hinweise für Ausführende

Wenn Sie von der DataPagerField -Klasse erben, müssen Sie die folgenden Member überschreiben:

Konstruktoren

DataPagerField()

Initialisiert eine neue Instanz der DataPagerField-Klasse.

Eigenschaften

DataPager

Ruft einen Verweis auf den Datenpager ab, dem das DataPagerField-Objekt zugeordnet ist.
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataPagerField-Objekt Änderungen seines Ansichtszustands verfolgt.
QueryStringHandled

Ruft Wert ab, der angibt, ob das Abfragezeichenfolgenfeld ausgewertet wurde, oder legt diesen fest.
QueryStringValue

Ruft den Wert des Abfragezeichenfolgenfelds aus der URL der Anforderung ab.
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataPagerField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.
Visible

Ruft einen Wert ab, der angibt, ob ein Datenpagerfeld gerendert werden soll, oder legt diesen fest.

Methoden

CloneField()

Erstellt eine Kopie des aktuellen Objekts, das von DataPagerField abgeleitet ist.
CopyProperties(DataPagerField)

Kopiert die Eigenschaften des aktuellen, von DataPagerField abgeleiteten Objekts in das angegebene DataPagerField-Objekt.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Erstellt beim Überschreiben in einer abgeleiteten Klasse die Benutzeroberflächen-Steuerelemente für das Datenpagerfeld-Objekt und fügt diese dem angegebenen Container hinzu.
CreateField()

Beim Überschreiben in einer abgeleiteten Klasse wird ein leeres, von DataPagerField abgeleitetes Objekt erstellt.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetQueryStringNavigateUrl(Int32)

Erstellt eine URL, die ein Abfragezeichenfolgenfeld mit der angegebenen Seitenzahl enthält.
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HandleEvent(CommandEventArgs)

Behandelt beim Überschreiben in einer abgeleiteten Klasse Ereignisse, die im Datenpagerfeld-Objekt eintreten.
LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.
SaveViewState()

Speichert die Änderungen, die am Ansichtszustand des DataPagerField-Objekts vorgenommen wurden.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Bewirkt, dass das DataPagerField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataPagerField-Objekt Änderungen seines Ansichtszustands verfolgt.
IStateManager.LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.
IStateManager.SaveViewState()

Speichert die Änderungen, die am Ansichtszustand des DataPagerField-Objekts vorgenommen wurden.
IStateManager.TrackViewState()

Bewirkt, dass das DataPagerField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

Gilt für:

Weitere Informationen