NextPreviousPagerField Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.Extensions.dll

Representerar ett fält som visar navigeringskontroller i en DataPager kontroll så att användarna kan bläddra igenom data.

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
Arv
Object
DataPagerField
NextPreviousPagerField

Exempel

I följande exempel visas hur du använder ett NextPreviousPagerField objekt för att bläddra igenom data som visas i en ListView kontroll.

<%@ 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>

Kommentarer

Klassen NextPreviousPagerField representerar ett fält som visar navigeringskontroller i en DataPager kontroll. Dessa navigeringskontroller kan användas för att bläddra igenom data som visas av en kontroll som implementerar IPageableItemContainer gränssnittet, till exempel ListView kontrollen.

Klassen NextPreviousPagerField innehåller knappar som gör det möjligt för användare att navigera genom datasidorna en sida i taget eller att hoppa till den första eller sista sidan med data.

Du kan anpassa objektets NextPreviousPagerField utseende med hjälp ButtonCssClass av egenskapen för att ange knapparnas format. Du kan också använda egenskapen ButtonType för att välja den typ av knapp som visas. I följande tabell visas de tillgängliga knapptyperna.

Knapptyp Description
Button En Button kontroll.
Image En ImageButton kontroll.
Link En LinkButton kontroll.

Du kan dölja ett NextPreviousPagerField objekt i en DataPager kontroll genom att ange Visible egenskapen till false. Du kan också dölja de enskilda knapparna (första sidan, föregående sida, nästa sida och sista sidans knappar) genom att ange ShowFirstPageButtonegenskaperna , ShowPreviousPageButton, ShowNextPageButtonoch ShowLastPageButton till false.

Med NextPreviousPagerField kontrollen kan du ange anpassad text för varje knapp med hjälp FirstPageTextav egenskaperna , PreviousPageText, NextPageTextoch LastPageText .

När egenskapen ButtonType är inställd ButtonType.Imagepå måste du ange URL:en till en bild som ska visas för knappen. Du kan ange bilder individuellt för varje knapp genom att FirstPageImageUrlange egenskaperna , PreviousPageImageUrl, NextPageImageUrloch LastPageImageUrl .

När egenskapen ButtonType är inställd på ButtonType.Imagefungerar motsvarande textegenskap som alternativ text för bilden. Till exempel visas den text som anges av FirstPageText egenskapen som alternativ text för bildknappen på första sidan. I webbläsare som stöder knappbeskrivningar visas även den här texten som en knappbeskrivning.

Konstruktorer

Name Description
NextPreviousPagerField()

Initierar en ny instans av NextPreviousPagerField klassen.

Egenskaper

Name Description
ButtonCssClass

Hämtar eller anger css-klassen (cascading style sheet) som används för att återge knapparna i sidfältet i webbläsaren.
ButtonType

Hämtar eller anger den knapptyp som ska visas i sidvisningsfältet.
DataPager

Hämtar en referens till datasökaren som DataPagerField objektet är associerat med.

(Ärvd från DataPagerField)
FirstPageImageUrl

Hämtar eller anger URL:en till en bild som visas för knappen på första sidan.
FirstPageText

Hämtar eller anger den text som visas för knappen på första sidan.
IsTrackingViewState

Hämtar ett värde som anger om objektet spårar ändringar i DataPagerField visningstillståndet.

(Ärvd från DataPagerField)
LastPageImageUrl

Hämtar eller anger URL:en till en bild som visas för knappen för sista sidan i NextPreviousPagerField objektet.
LastPageText

Hämtar eller anger den text som visas för knappen för sista sidan.
NextPageImageUrl

Hämtar eller anger URL:en till en bild som visas för knappen nästa sida i NextPreviousPagerField objektet.
NextPageText

Hämtar eller anger den text som visas för knappen nästa sida.
PreviousPageImageUrl

Hämtar eller anger URL:en till en bild som visas för knappen föregående sida i NextPreviousPagerField objektet.
PreviousPageText

Hämtar eller anger den text som visas för knappen föregående sida.
QueryStringHandled

Hämtar eller anger ett värde som anger om frågesträngsfältet har utvärderats.

(Ärvd från DataPagerField)
QueryStringValue

Hämtar värdet för frågesträngsfältet från URL:en för begäran.

(Ärvd från DataPagerField)
RenderDisabledButtonsAsLabels

Hämtar eller anger ett värde som anger om inaktiverade knappar återges som Label kontroller av objektet NextPreviousPagerField .
RenderNonBreakingSpacesBetweenControls

Hämtar eller anger ett värde som anger om icke-icke-icke-bakåtkompatibla blanksteg återges mellan kontroller.
ShowFirstPageButton

Hämtar eller anger ett värde som anger om knappen på första sidan visas i ett NextPreviousPagerField objekt.
ShowLastPageButton

Hämtar eller anger ett värde som anger om knappen på sista sidan visas i ett NextPreviousPagerField objekt.
ShowNextPageButton

Hämtar eller anger ett värde som anger om knappen nästa sida visas i ett NextPreviousPagerField objekt.
ShowPreviousPageButton

Hämtar eller anger ett värde som anger om knappen på föregående sida visas i ett NextPreviousPagerField objekt.
ViewState

Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett DataPagerField objekt över flera begäranden för samma sida.

(Ärvd från DataPagerField)
Visible

Hämtar eller anger ett värde som anger om ett datasidesfält återges.

(Ärvd från DataPagerField)

Metoder

Name Description
CloneField()

Skapar en kopia av det aktuella objektet som härleds från DataPagerField.

(Ärvd från DataPagerField)
CopyProperties(DataPagerField)

Kopierar egenskaperna för det aktuella NextPreviousPagerField objektet till det angivna DataPagerField objektet.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Skapar användargränssnittskontrollerna (UI) för pager-fältobjektet och lägger till dem i den angivna containern.
CreateField()

Skapar och returnerar en ny instans av NextPreviousPagerField klassen.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella NextPreviousPagerField objektet.
GetHashCode()

Fungerar som en hash-funktion för NextPreviousPagerField klassen.
GetQueryStringNavigateUrl(Int32)

Skapar en URL som innehåller ett frågesträngsfält som har det angivna sidnumret.

(Ärvd från DataPagerField)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
HandleEvent(CommandEventArgs)

Hanterar händelser som inträffar i NextPreviousPagerField kontrollen och utför lämplig åtgärd.
LoadViewState(Object)

Återställer visningstillståndsinformation som sparades tidigare.

(Ärvd från DataPagerField)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnFieldChanged()

Genererar händelsen FieldChanged .

(Ärvd från DataPagerField)
SaveViewState()

Sparar de ändringar som har gjorts i DataPagerField objektets visningstillstånd.

(Ärvd från DataPagerField)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TrackViewState()

DataPagerField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida.

(Ärvd från DataPagerField)

Explicita gränssnittsimplementeringar

Name Description
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om objektet spårar ändringar i DataPagerField visningstillståndet.

(Ärvd från DataPagerField)
IStateManager.LoadViewState(Object)

Återställer visningstillståndsinformation som sparades tidigare.

(Ärvd från DataPagerField)
IStateManager.SaveViewState()

Sparar de ändringar som har gjorts i DataPagerField objektets visningstillstånd.

(Ärvd från DataPagerField)
IStateManager.TrackViewState()

DataPagerField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida.

(Ärvd från DataPagerField)

Gäller för

Se även