NextPreviousPagerField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

Freigeben über