DataPagerField DataPagerField DataPagerField DataPagerField Class

Definition

Dient als Basisklasse für Datenpager-Feldtypen, die ein Navigationssteuerelement für das DataPager-Steuerelement darstellen.Serves as the base class for data pager field types, which represent a navigation control for the DataPager control.

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
DataPagerFieldDataPagerFieldDataPagerFieldDataPagerField
Abgeleitet
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie NextPreviousPagerFielddie NumericPagerField-, TemplatePagerField -und-Objekte verwendet werden, um DataPager Seiten Navigations Steuerelemente in einem-Steuerelement anzuzeigenThe following example shows how to use NextPreviousPagerField, NumericPagerField, and TemplatePagerField objects to display page navigation controls in a DataPager control. Die-Objekte werden von der DataPagerField -Klasse abgeleitet.The objects are derived from the DataPagerField class.

<%@ 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>&nbsp;</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="&lt;&lt;"
            NextPageText="&gt;&gt;"
            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>&nbsp;</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="&lt;&lt;"
            NextPageText="&gt;&gt;"
            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 fungiert als Basisklasse für alle Data Pager-Feldtypen.The DataPagerField class serves as the base class for all data pager field types. Datpager-Felder werden vom DataPager -Steuerelement verwendet, um ein Navigations Steuerelement darzustellen.Data pager fields are used by the DataPager control to represent a navigation control.

Verwenden Sie die Klassen, die von DataPagerField abgeleitet werden, um den Typ des Pager auszuwählen, DataPager der im Steuerelement angezeigt wird.Use the classes that are derived from DataPagerField to select which type of pager is displayed in the DataPager control. In der folgenden Tabelle sind die verfügbaren Feld Typen von Data Pager aufgeführt.The following table lists available data pager field types.

Pager-FeldtypPager field type BeschreibungDescription
NextPreviousPagerField Ermöglicht Benutzern eine Seite gleichzeitig die Navigation durch Datenseiten oder das Springen zur ersten oder letzten Seite.Lets users navigate through data pages one page at a time, or to jump to the first or last page.
NumericPagerField Ermöglicht Benutzern das Auswählen einer Seite nach Seitenzahl.Lets users select a page by page number.
TemplatePagerField Ermöglicht Seiten Entwicklern das Erstellen einer benutzerdefinierten Pagingbenutzeroberfläche.Lets page developers create a custom paging UI.

Sie können von der DataPagerField -Klasse ableiten, um zusätzliche Pager-Feldtypen zu erstellen.You can derive from the DataPagerField class to create additional pager field types.

Hinweise für Vererber

Wenn Sie von der DataPagerField -Klasse erben, müssen Sie die folgenden Member überschreiben:When you inherit from the DataPagerField class, you must override the following members:

Konstruktoren

DataPagerField() DataPagerField() DataPagerField() DataPagerField()

Initialisiert eine neue Instanz der DataPagerField-Klasse.Initializes a new instance of the DataPagerField class.

Eigenschaften

DataPager DataPager DataPager DataPager

Ruft einen Verweis auf den Datenpager ab, dem das DataPagerField-Objekt zugeordnet ist.Gets a reference to the data pager that the DataPagerField object is associated with.

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataPagerField-Objekt Änderungen seines Ansichtszustands verfolgt.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

QueryStringHandled QueryStringHandled QueryStringHandled QueryStringHandled

Ruft Wert ab, der angibt, ob das Abfragezeichenfolgenfeld ausgewertet wurde, oder legt diesen fest.Gets or sets a value that indicates whether the query string field has been evaluated.

QueryStringValue QueryStringValue QueryStringValue QueryStringValue

Ruft den Wert des Abfragezeichenfolgenfelds aus der URL der Anforderung ab.Gets the value of the query string field from the URL of the request.

ViewState ViewState ViewState 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.Gets a dictionary of state information that enables you to save and restore the view state of a DataPagerField object across multiple requests for the same page.

Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob ein Datenpagerfeld gerendert werden soll, oder legt diesen fest.Gets or sets a value that indicates whether a data pager field is rendered.

Methoden

CloneField() CloneField() CloneField() CloneField()

Erstellt eine Kopie des aktuellen Objekts, das von DataPagerField abgeleitet ist.Creates a copy of the current object that is derived from DataPagerField.

CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField)

Kopiert die Eigenschaften des aktuellen, von DataPagerField abgeleiteten Objekts in das angegebene DataPagerField-Objekt.Copies the properties of the current object derived from DataPagerField to the specified DataPagerField object.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) 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.When overridden in a derived class, creates the user interface (UI) controls for the data pager field object and adds them to the specified container.

CreateField() CreateField() CreateField() CreateField()

Beim Überschreiben in einer abgeleiteten Klasse wird ein leeres, von DataPagerField abgeleitetes Objekt erstellt.When overridden in a derived class, creates an empty object that is derived DataPagerField.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32)

Erstellt eine URL, die ein Abfragezeichenfolgenfeld mit der angegebenen Seitenzahl enthält.Creates a URL that contains a query string field that has the specified page number.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs)

Behandelt beim Überschreiben in einer abgeleiteten Klasse Ereignisse, die im Datenpagerfeld-Objekt eintreten.When overridden in a derived class, handles events that occur in the data pager field object.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.Restores view-state information that was saved previously.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen, die am Ansichtszustand des DataPagerField-Objekts vorgenommen wurden.Saves the changes that were made to the DataPagerField object's view state.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataPagerField-Objekt Änderungen seines Ansichtszustands verfolgt.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.Restores view-state information that was saved previously.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen, die am Ansichtszustand des DataPagerField-Objekts vorgenommen wurden.Saves the changes that were made to the DataPagerField object's view state.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

Gilt für:

Siehe auch