NextPreviousPagerField Klasse

Definition

Stellt ein Feld dar, das Navigationssteuerelemente in einem DataPager-Steuerelement anzeigt, das Benutzern das Durchblättern der Daten ermöglicht.

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField
public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField
type NextPreviousPagerField = class
    inherit DataPagerField
Public Class NextPreviousPagerField
Inherits DataPagerField
Vererbung
NextPreviousPagerField

Beispiele

Das folgende Beispiel zeigt, wie Sie ein NextPreviousPagerField -Objekt verwenden, um Daten zu durchlaufen, die in einem ListView Steuerelement angezeigt werden.

<%@ 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Hinweise

Die NextPreviousPagerField -Klasse stellt ein Feld dar, das Navigationssteuerelemente in einem DataPager Steuerelement anzeigt. Diese Navigationssteuerelemente können verwendet werden, um Daten zu durchlaufen, die von einem Steuerelement angezeigt werden, das die IPageableItemContainer Schnittstelle implementiert, z. B. das ListView -Steuerelement.

Die NextPreviousPagerField -Klasse stellt Schaltflächen bereit, mit denen Benutzer seitenseitig durch die Datenseiten navigieren oder zur ersten oder letzten Datenseite springen können.

Sie können die Darstellung des NextPreviousPagerField Objekts anpassen, indem Sie die ButtonCssClass -Eigenschaft verwenden, um den Stil der Schaltflächen festzulegen. Sie können auch die ButtonType -Eigenschaft verwenden, um den Typ der angezeigten Schaltfläche auszuwählen. In der folgenden Tabelle sind die verfügbaren Schaltflächentypen aufgeführt.

Schaltflächentyp BESCHREIBUNG
Button Ein Button-Steuerelement.
Image Ein ImageButton-Steuerelement.
Link Ein LinkButton-Steuerelement.

Sie können ein NextPreviousPagerField Objekt in einem DataPager Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen. Sie können auch die einzelnen Schaltflächen ausblenden (die Schaltflächen erste Seite, vorherige Seite, nächste Seite und letzte Seite), indem Sie die ShowFirstPageButtonEigenschaften , ShowPreviousPageButton, ShowNextPageButtonund ShowLastPageButton auf falsefestlegen.

Mit NextPreviousPagerField dem Steuerelement können Sie benutzerdefinierten Text für jede Schaltfläche angeben, indem Sie die FirstPageTextEigenschaften , PreviousPageText, NextPageTextund LastPageText verwenden.

Wenn die ButtonType Eigenschaft auf ButtonType.Imagefestgelegt ist, müssen Sie die URL für ein Bild angeben, das für die Schaltfläche angezeigt wird. Sie können Bilder für jede Schaltfläche einzeln festlegen, indem Sie die FirstPageImageUrlEigenschaften , PreviousPageImageUrl, NextPageImageUrlund LastPageImageUrl festlegen.

Wenn die ButtonType -Eigenschaft auf ButtonType.Imagefestgelegt ist, fungiert die entsprechende Texteigenschaft als alternativer Text für das Bild. Beispielsweise wird der Text, der von der FirstPageText -Eigenschaft angegeben wird, als alternativer Text für die Bildschaltfläche der ersten Seite angezeigt. In Browsern, die QuickInfos unterstützen, wird dieser Text auch als QuickInfo angezeigt.

Konstruktoren

NextPreviousPagerField()

Initialisiert eine neue Instanz der NextPreviousPagerField-Klasse.

Eigenschaften

ButtonCssClass

Ruft die CSS-Klasse (Cascading Style Sheet) ab, die zum Rendern der Schaltflächen des Pagerfelds im Browser verwendet wird.

ButtonType

Ruft den Schaltflächentyp ab, der im Pagerfeld angezeigt werden soll, oder legt diesen fest.

DataPager

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

(Geerbt von DataPagerField)
FirstPageImageUrl

Ruft die URL zu einem Bild ab, das für die Erste Seite-Schaltfläche angezeigt wird, oder legt diese fest.

FirstPageText

Ruft den für die Erste Seite-Schaltfläche angezeigten Text ab oder legt diesen fest.

IsTrackingViewState

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

(Geerbt von DataPagerField)
LastPageImageUrl

Ruft die URL zu einem Bild ab, das für die Letzte Seite-Schaltfläche im NextPreviousPagerField-Objekt angezeigt wird, oder legt diese fest.

LastPageText

Ruft den für die Letzte Seite-Schaltfläche angezeigten Text ab oder legt diesen fest.

NextPageImageUrl

Ruft die URL zu einem Bild ab, das für die Nächste Seite-Schaltfläche im NextPreviousPagerField-Objekt angezeigt wird, oder legt diese fest.

NextPageText

Ruft den für die Nächste Seite-Schaltfläche angezeigten Text ab oder legt diesen fest.

PreviousPageImageUrl

Ruft die URL zu einem Bild ab, das für die Vorherige Seite-Schaltfläche im NextPreviousPagerField-Objekt angezeigt wird, oder legt diese fest.

PreviousPageText

Ruft den für die Vorherige Seite-Schaltfläche angezeigten Text ab oder legt diesen fest.

QueryStringHandled

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

(Geerbt von DataPagerField)
QueryStringValue

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

(Geerbt von DataPagerField)
RenderDisabledButtonsAsLabels

Ruft einen Wert ab, der angibt, ob deaktivierte Schaltflächen vom Label-Objekt als NextPreviousPagerField-Steuerelemente gerendert werden, oder legt diesen fest.

RenderNonBreakingSpacesBetweenControls

Ruft einen Wert ab, der angibt, ob zwischen Steuerelementen feste Leerzeichen gerendert werden, oder legt diesen fest.

ShowFirstPageButton

Ruft ab oder legt einen Wert fest, der angibt, ob die Erste Seite-Schaltfläche in einem NextPreviousPagerField-Objekt angezeigt wird.

ShowLastPageButton

Ruft ab oder legt einen Wert fest, der angibt, ob die Letzte Seite-Schaltfläche in einem NextPreviousPagerField-Objekt angezeigt wird.

ShowNextPageButton

Ruft ab oder legt einen Wert fest, der angibt, ob die Nächste Seite-Schaltfläche in einem NextPreviousPagerField-Objekt angezeigt wird.

ShowPreviousPageButton

Ruft ab oder legt einen Wert fest, der angibt, ob die Vorherige Seite-Schaltfläche in einem NextPreviousPagerField-Objekt angezeigt wird.

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.

(Geerbt von DataPagerField)
Visible

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

(Geerbt von DataPagerField)

Methoden

CloneField()

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

(Geerbt von DataPagerField)
CopyProperties(DataPagerField)

Kopiert die Eigenschaften des aktuellen NextPreviousPagerField-Objekts in das angegebene DataPagerField-Objekt.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Erstellt die UI-Steuerelemente (User Interface, Benutzeroberfläche) für das Pagerfeldobjekt und fügt diese dem angegebenen Container hinzu.

CreateField()

Erstellt und gibt eine neue Instanz der NextPreviousPagerField-Klasse zurück.

Equals(Object)

Bestimmt, ob das angegebene Objekt und das aktuelle NextPreviousPagerField-Objekt gleich sind.

GetHashCode()

Fungiert als eine Hashfunktion für die NextPreviousPagerField-Klasse.

GetQueryStringNavigateUrl(Int32)

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

(Geerbt von DataPagerField)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HandleEvent(CommandEventArgs)

Behandelt Ereignisse, die im NextPreviousPagerField-Steuerelement auftreten, und führt die entsprechende Aktion aus.

LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.

(Geerbt von DataPagerField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.

(Geerbt von DataPagerField)
SaveViewState()

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

(Geerbt von DataPagerField)
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.

(Geerbt von DataPagerField)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState

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

(Geerbt von DataPagerField)
IStateManager.LoadViewState(Object)

Stellt zuvor gespeicherte Ansichtszustandsinformationen wieder her.

(Geerbt von DataPagerField)
IStateManager.SaveViewState()

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

(Geerbt von DataPagerField)
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.

(Geerbt von DataPagerField)

Gilt für:

Weitere Informationen