NumericPagerField 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 DataPager-Feld dar, das Benutzern das Auswählen einer Seite anhand der Seitennummer ermöglicht.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField

public class NumericPagerField : System.Web.UI.WebControls.DataPagerField

type NumericPagerField = class
    inherit DataPagerField

Public Class NumericPagerField
Inherits DataPagerField

Vererbung: Object

DataPagerField
NumericPagerField

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein NumericPagerField -Objekt verwendet wird, 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>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- 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>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- 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 NumericPagerField -Klasse zeigt Navigationssteuerelemente in einem DataPager -Steuerelement an. Die Steuerelemente können verwendet werden, um Daten zu durchlaufen, die von einem Steuerelement angezeigt werden, das die IPageableItemContainer Schnittstelle implementiert, z. B. das ListView -Steuerelement. Das NumericPagerField -Objekt zeigt Seitenzahlen als Schaltflächen an, auf die Benutzer klicken können, um zu einer bestimmten Seite zu wechseln. Das Steuerelement zeigt auch Schaltflächen für die nächste Seite und die vorherige Seite an, mit denen Benutzer auf mehr Datenseiten zugreifen können als die, die vom Steuerelement angezeigt werden.

Sie können die Darstellung des NumericPagerField Objekts anpassen, indem Sie die Eigenschaften verwenden, die in der folgenden Tabelle aufgeführt sind.

Eigenschaft	BESCHREIBUNG
CurrentPageLabelCssClass	Die CSS-Klasse für die aktuelle Seitenzahl.
NextPreviousButtonCssClass	Die CSS-Klasse für die Schaltflächen next-page und previous-page.
NumericButtonCssClass	Die CSS-Klasse für die Schaltflächen, die die Seitenzahlen darstellen.

Sie können 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
ButtonType.Button	Ein Button-Steuerelement.
ButtonType.Image	Ein ImageButton-Steuerelement.
ButtonType.Link	Ein LinkButton-Steuerelement.

Die Steuerelemente im NumericButtonCssClass -Objekt werden mit unterbrechungsfreien Leerzeichen zwischen ihnen gerendert. Wenn Sie dieses Verhalten anpassen möchten, können Sie die RenderNonBreakingSpacesBetweenControls -Eigenschaft verwenden.

Sie können ein NumericPagerField Objekt in einem DataPager Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen. Sie können die Sichtbarkeit der Schaltflächen "Nächste Seite" und "Vorherige Seite" nicht steuern. Sie werden vom -Steuerelement angezeigt, wenn dem zugeordneten Datensteuerelement zusätzliche Seiten zur Anzeige zur Verfügung stehen. Sie können die ButtonCount -Eigenschaft verwenden, um anzugeben, wie viele Schaltflächen in einem NumericPagerField -Objekt angezeigt werden. Jede Schaltfläche entspricht einer Seitenzahl.

Sie können den Text der Schaltfläche für die nächste Seite festlegen, indem Sie die NextPageText -Eigenschaft festlegen. Sie können den Text der Schaltfläche "Vorherige Seite" mithilfe der PreviousPageText -Eigenschaft festlegen.

Wenn die ButtonType -Eigenschaft auf ButtonType.Imagefestgelegt ist, müssen Sie die URL eines Bilds angeben, das für die Schaltflächen nächste Seite und vorherige Seite angezeigt wird. Hierzu legen Sie die NextPageImageUrl Eigenschaften und PreviousPageImageUrl fest. In diesem Fall wird die entsprechende Texteigenschaft als Alternativtext für das Bild verwendet. Beispielsweise wird der text, der von der NextPageImageUrl -Eigenschaft angegeben wird, als Alternativtext für die Schaltfläche "Bild der nächsten Seite" angezeigt. In Browsern, die QuickInfos unterstützen, wird dieser Text auch als QuickInfo für die entsprechende Schaltfläche angezeigt.

Konstruktoren

NumericPagerField()

Initialisiert eine neue Instanz der NumericPagerField-Klasse.

Eigenschaften

ButtonCount	Ruft die Anzahl der Schaltflächen ab, die in einem NumericPagerField-Objekt angezeigt werden, oder legt diese fest.
ButtonType	Ruft den Schaltflächentyp ab, der im Pagerfeld angezeigt werden soll, oder legt diesen fest.
CurrentPageLabelCssClass	Ruft die CSS-Klasse (Cascading Style Sheet) ab, mit der der aktuellen Seitenzahl ein Format zugewiesen wird, oder legt diese fest.
DataPager	Ruft einen Verweis auf den Datenpager ab, dem das DataPagerField-Objekt zugeordnet ist. (Geerbt von DataPagerField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataPagerField-Objekt Änderungen seines Ansichtszustands verfolgt. (Geerbt von DataPagerField)
NextPageImageUrl	Ruft die URL zu einem Bild ab, das für die Schaltfläche für den Wechsel zur nächsten Seite im NumericPagerField-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.
NextPreviousButtonCssClass	Ruft die CSS-Klasse (Cascading Style Sheet) ab, die zum Formatieren der Schaltflächen für den Wechsel zur nächsten und zur vorherigen Seite des Pagerfelds verwendet wird, oder legt diese fest.
NumericButtonCssClass	Ruft die CSS-Klasse (Cascading Style Sheet) ab, die zum Formatieren der Seitenzahlen-Schaltflächen des Pagerfelds verwendet wird, oder legt diese fest.
PreviousPageImageUrl	Ruft die URL eines Bilds ab, das für die Schaltfläche für den Wechsel zur vorherigen Seite im NumericPagerField-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)
RenderNonBreakingSpacesBetweenControls	Ruft einen Wert ab, der angibt, ob zwischen Steuerelementen feste Leerzeichen gerendert werden, oder legt diesen fest.
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 NumericPagerField-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 NumericPagerField-Klasse zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt und das aktuelle NumericPagerField-Objekt gleich sind.
GetHashCode()	Fungiert als eine Hashfunktion für die NumericPagerField-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 NumericPagerField-Objekt 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