NextPreviousPagerField Klasse
Definition
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
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie ein NextPreviousPagerField Objekt verwenden, um Daten anzuzeigen, 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 zum Aufblättern von Daten verwendet werden, die von einem Steuerelement angezeigt werden, das die Schnittstelle implementiert, z. B. das IPageableItemContainer ListView Steuerelement.
Die NextPreviousPagerField Klasse bietet Schaltflächen, mit denen Benutzer zu einer Zeit über die Seiten von Daten navigieren oder zu der ersten oder letzten Seite von Daten springen können.
Sie können die Darstellung des NextPreviousPagerField Objekts ButtonCssClass mithilfe der Eigenschaft anpassen, um die Formatvorlage der Schaltflächen festzulegen. Sie können auch die Eigenschaft verwenden, um den Typ der Schaltfläche auszuwählen, die ButtonType angezeigt wird. 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 false
" festlegen. Sie können auch die einzelnen Schaltflächen (die Schaltflächen "Erste Seite", "Vorherige Seite", "Nächste Seite" und "Letzte Seite") ausblenden, indem Sie die ShowFirstPageButtonSchaltflächen ", " , ShowPreviousPageButtonShowNextPageButton" und ShowLastPageButton "Eigenschaften" auf false
"" festlegen.
Mit dem NextPreviousPagerField Steuerelement können Sie benutzerdefinierten Text für jede Schaltfläche mithilfe der FirstPageTextEigenschaften , NextPageTextPreviousPageTextund LastPageText Eigenschaften angeben.
Wenn die ButtonType Eigenschaft auf ButtonType.Image
"Festgelegt" festgelegt ist, müssen Sie die URL für ein Bild angeben, das für die Schaltfläche angezeigt wird. Sie können Bilder einzeln für jede Schaltfläche festlegen, indem Sie die FirstPageImageUrlEigenschaften , PreviousPageImageUrl, NextPageImageUrl, und LastPageImageUrl Eigenschaften festlegen.
Wenn die Eigenschaft auf ButtonType.Image
"" festgelegt ist, fungiert die ButtonType entsprechende Texteigenschaft als Alternativtext für das Bild. Beispielsweise wird der text, der von der FirstPageText Eigenschaft angegeben wird, als alternativtext für die Schaltfläche "Erste 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 |
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) |