NumericPagerField Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
DataPager Reprezentuje pole, które umożliwia użytkownikom wybranie strony według numeru strony.
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
- Dziedziczenie
Przykłady
W poniższym przykładzie pokazano, jak używać NumericPagerField obiektu do stronicowania danych wyświetlanych w kontrolce ListView .
<%@ 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>
Uwagi
Klasa NumericPagerField wyświetla kontrolki nawigacji w kontrolce DataPager . Kontrolki mogą służyć do stronicowania danych wyświetlanych przez kontrolkę, która implementuje IPageableItemContainer interfejs, taki jak kontrolka ListView . Obiekt NumericPagerField wyświetla numery stron jako przyciski, które użytkownicy mogą kliknąć, aby przejść do określonej strony. Kontrolka wyświetla również przyciski następnej strony i poprzedniej strony, które umożliwiają użytkownikom dostęp do większej liczby stron danych niż te, które są wyświetlane przez kontrolkę.
Wygląd obiektu można dostosować NumericPagerField przy użyciu właściwości wymienionych w poniższej tabeli.
Właściwość | Opis |
---|---|
CurrentPageLabelCssClass | Klasa CSS dla bieżącego numeru strony. |
NextPreviousButtonCssClass | Klasa CSS dla przycisków następnej strony i poprzedniej strony. |
NumericButtonCssClass | Klasa CSS dla przycisków reprezentujących numery stron. |
Możesz użyć właściwości , ButtonType aby wybrać typ przycisku, który zostanie wyświetlony. W poniższej tabeli wymieniono dostępne typy przycisków.
Typ przycisku | Opis |
---|---|
ButtonType.Button | Kontrolka Button . |
ButtonType.Image | Kontrolka ImageButton . |
ButtonType.Link | Kontrolka LinkButton . |
Kontrolki wewnątrz NumericButtonCssClass obiektu są renderowane z niełamanymi spacjami między nimi. Jeśli chcesz dostosować to zachowanie, możesz użyć RenderNonBreakingSpacesBetweenControls właściwości .
Obiekt można ukryć NumericPagerField w kontrolce DataPager , ustawiając Visible właściwość na false
. Nie można kontrolować widoczności przycisków następnej strony i poprzednich stron. Są one wyświetlane przez kontrolkę, jeśli skojarzona kontrolka danych ma dostępne dodatkowe strony do wyświetlenia. Za pomocą ButtonCount właściwości można określić liczbę przycisków wyświetlanych w NumericPagerField obiekcie. Każdy przycisk odpowiada numerowi strony.
Tekst przycisku następnej strony można ustawić, ustawiając NextPageText właściwość. Tekst przycisku poprzedniej strony można ustawić przy użyciu PreviousPageText właściwości .
Po ustawieniu ButtonType właściwości na ButtonType.Imagewartość , należy podać adres URL obrazu, który będzie wyświetlany dla przycisków następnej strony i poprzedniej strony. W tym celu należy ustawić NextPageImageUrl właściwości i PreviousPageImageUrl . W takim przypadku odpowiednia właściwość tekstowa jest używana jako tekst alternatywny obrazu. Na przykład tekst określony przez NextPageImageUrl właściwość jest wyświetlany jako tekst alternatywny przycisku obrazu na następnej stronie. W przeglądarkach obsługujących etykietki narzędzi ten tekst jest również wyświetlany jako etykietka narzędzia odpowiedniego przycisku.
Konstruktory
NumericPagerField() |
Inicjuje nowe wystąpienie klasy NumericPagerField. |
Właściwości
ButtonCount |
Pobiera lub ustawia liczbę przycisków do wyświetlenia w NumericPagerField obiekcie. |
ButtonType |
Pobiera lub ustawia typ przycisku do wyświetlenia w polu pager. |
CurrentPageLabelCssClass |
Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS), która jest używana do stylu bieżącego numeru strony. |
DataPager |
Pobiera odwołanie do stronicowania danych skojarzonego DataPagerField z obiektem. (Odziedziczone po DataPagerField) |
IsTrackingViewState |
Pobiera wartość wskazującą, czy DataPagerField obiekt śledzi zmiany stanu widoku. (Odziedziczone po DataPagerField) |
NextPageImageUrl |
Pobiera lub ustawia adres URL obrazu wyświetlanego dla przycisku następnej strony w NumericPagerField obiekcie. |
NextPageText |
Pobiera lub ustawia tekst wyświetlany dla przycisku następnej strony. |
NextPreviousButtonCssClass |
Pobiera lub ustawia kaskadową klasę arkusza stylów (CSS), która służy do stylu przycisków następnej strony i poprzednich stron pola pager. |
NumericButtonCssClass |
Pobiera lub ustawia kaskadową klasę arkusza stylów (CSS), która służy do stylu przycisków numerów strony pola pager. |
PreviousPageImageUrl |
Pobiera lub ustawia adres URL obrazu wyświetlanego dla przycisku poprzedniej NumericPagerField strony w obiekcie. |
PreviousPageText |
Pobiera lub ustawia tekst wyświetlany dla przycisku poprzedniej strony. |
QueryStringHandled |
Pobiera lub ustawia wartość wskazującą, czy pole ciągu zapytania zostało ocenione. (Odziedziczone po DataPagerField) |
QueryStringValue |
Pobiera wartość pola ciągu zapytania z adresu URL żądania. (Odziedziczone po DataPagerField) |
RenderNonBreakingSpacesBetweenControls |
Pobiera lub ustawia wartość wskazującą, czy spacje powodujące niezgodność zostaną renderowane między kontrolkami. |
ViewState |
Pobiera słownik informacji o stanie, który umożliwia zapisywanie i przywracanie stanu DataPagerField widoku obiektu w wielu żądaniach dla tej samej strony. (Odziedziczone po DataPagerField) |
Visible |
Pobiera lub ustawia wartość wskazującą, czy pole stronicowania danych jest renderowane. (Odziedziczone po DataPagerField) |
Metody
CloneField() |
Tworzy kopię bieżącego obiektu, który pochodzi z DataPagerFieldklasy . (Odziedziczone po DataPagerField) |
CopyProperties(DataPagerField) |
Kopiuje właściwości bieżącego NumericPagerField obiektu do określonego DataPagerField obiektu. |
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Tworzy kontrolki interfejsu użytkownika dla obiektu pola pager i dodaje je do określonego kontenera. |
CreateField() |
Tworzy i zwraca nowe wystąpienie NumericPagerField klasy. |
Equals(Object) |
Określa, czy określony obiekt jest równy bieżącemu NumericPagerField obiektowi. |
GetHashCode() |
Służy jako funkcja skrótu NumericPagerField dla klasy. |
GetQueryStringNavigateUrl(Int32) |
Tworzy adres URL zawierający pole ciągu zapytania, które ma określony numer strony. (Odziedziczone po DataPagerField) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
HandleEvent(CommandEventArgs) |
Obsługuje zdarzenia występujące w NumericPagerField obiekcie i wykonuje odpowiednią akcję. |
LoadViewState(Object) |
Przywraca informacje o stanie widoku, które zostały zapisane wcześniej. (Odziedziczone po DataPagerField) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnFieldChanged() |
|
SaveViewState() |
Zapisuje zmiany wprowadzone w DataPagerField stanie widoku obiektu. (Odziedziczone po DataPagerField) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
TrackViewState() |
DataPagerField Powoduje, że obiekt śledzi zmiany w stanie widoku, aby można je było przechowywać we właściwości kontrolki ViewState i utrwalać na żądaniach dla tej samej strony. (Odziedziczone po DataPagerField) |
Jawne implementacje interfejsu
IStateManager.IsTrackingViewState |
Pobiera wartość wskazującą, czy DataPagerField obiekt śledzi zmiany stanu widoku. (Odziedziczone po DataPagerField) |
IStateManager.LoadViewState(Object) |
Przywraca informacje o stanie widoku, które zostały zapisane wcześniej. (Odziedziczone po DataPagerField) |
IStateManager.SaveViewState() |
Zapisuje zmiany wprowadzone w DataPagerField stanie widoku obiektu. (Odziedziczone po DataPagerField) |
IStateManager.TrackViewState() |
DataPagerField Powoduje, że obiekt śledzi zmiany w stanie widoku, aby można je było przechowywać we właściwości kontrolki ViewState i utrwalać na żądaniach dla tej samej strony. (Odziedziczone po DataPagerField) |