NumericPagerField 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 DataPager-Feld dar, das Benutzern das Auswählen einer Seite anhand der Seitennummer ermöglicht.
public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerFieldpublic class NumericPagerField : System.Web.UI.WebControls.DataPagerFieldtype NumericPagerField = class
inherit DataPagerFieldPublic Class NumericPagerField
Inherits DataPagerField- Vererbung
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 |
| 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) |
