DataGridPagerStyle 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

指定 DataGrid 控制項的頁面巡覽區樣式。此類別無法獲得繼承。

public ref class DataGridPagerStyle sealed : System::Web::UI::WebControls::TableItemStyle

public sealed class DataGridPagerStyle : System.Web.UI.WebControls.TableItemStyle

type DataGridPagerStyle = class
    inherit TableItemStyle

Public NotInheritable Class DataGridPagerStyle
Inherits TableItemStyle

繼承: Object

MarshalByRefObject

Component

Style

TableItemStyle
DataGridPagerStyle

範例

下列程式碼範例示範如何使用 DataGridPagerStyle 物件來表示屬性中 PagerStyle 頁面巡覽項的樣式。物件 DataGridPagerStyle 會設定分頁專案的顯示模式和對齊方式。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("DateTimeValue", typeof(string)));
         dt.Columns.Add(new DataColumn("BoolValue", typeof(bool)));
 
         for (int i = 0; i < 100; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = DateTime.Now.ToShortDateString();
            dr[3] = (i % 2 != 0) ? true : false;
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
         if (chk1.Checked)
            MyDataGrid.PagerStyle.Mode = PagerMode.NumericPages;
         else 
            MyDataGrid.PagerStyle.Mode = PagerMode.NextPrev;
 
         BindGrid();
      }
 
      void MyDataGrid_Page(Object sender, DataGridPageChangedEventArgs e) 
      {
         MyDataGrid.CurrentPageIndex = e.NewPageIndex;
         BindGrid();
      }
 
      void BindGrid() 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
         ShowStats();
      }
 
      void ShowStats() 
      {
         lblEnabled.Text = "AllowPaging is " + MyDataGrid.AllowPaging;
         lblCurrentIndex.Text = "CurrentPageIndex is " + MyDataGrid.CurrentPageIndex;
         lblPageCount.Text = "PageCount is " + MyDataGrid.PageCount;
         lblPageSize.Text = "PageSize is " + MyDataGrid.PageSize;
      }
 
 
   </script>
 
<head runat="server">
    <title>Paging with DataGrid</title>
</head>
<body>
 
   <h3>Paging with DataGrid</h3>
 
   <form id="form1" runat="server">
 
      <asp:DataGrid id="MyDataGrid" runat="server"
           AllowPaging="True"
           PageSize="10"
           PagerStyle-Mode="NumericPages"
           PagerStyle-HorizontalAlign="Right"
           OnPageIndexChanged="MyDataGrid_Page"
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           CellPadding="3"
           CellSpacing="0"
           Font-Names="Verdana"
           Font-Size="8pt"
           HeaderStyle-BackColor="#aaaadd"
           AlternatingItemStyle-BackColor="#eeeeee"/>
 
      <br />
 
      <asp:Checkbox id="chk1" runat="server"
           Text="Show numeric page navigation buttons"
           Font-Names="Verdana"
           Font-Size="8pt"
           AutoPostBack="true"/>
 
      <br />
 
      <table style="background-color:#eeeeee; padding:6">
         <tr>
            <td style="display:inline">
               
 
                  <asp:Label id="lblEnabled" 
                       runat="server"/><br />
                  <asp:Label id="lblCurrentIndex" 
                       runat="server"/><br />
                  <asp:Label id="lblPageCount" 
                       runat="server"/><br />
                  <asp:Label id="lblPageSize" 
                        runat="server"/><br />
 
               
            </td>
         </tr>
      </table>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
 
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("DateTimeValue", GetType(String)))
        dt.Columns.Add(New DataColumn("BoolValue", GetType(Boolean)))
        
        Dim i As Integer
        For i = 0 To 99
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " & i.ToString()
            dr(2) = DateTime.Now.ToShortDateString()
            If i Mod 2 <> 0 Then
                dr(3) = True
            Else
                dr(3) = False
            End If
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource

    Sub Page_Load(sender As Object, e As EventArgs)
        If chk1.Checked Then
            MyDataGrid.PagerStyle.Mode = PagerMode.NumericPages
        Else
            MyDataGrid.PagerStyle.Mode = PagerMode.NextPrev
        End If 
        BindGrid()
    End Sub 'Page_Load

    Sub MyDataGrid_Page(sender As Object, e As DataGridPageChangedEventArgs)
        MyDataGrid.CurrentPageIndex = e.NewPageIndex
        BindGrid()
    End Sub 'MyDataGrid_Page

    Sub BindGrid()
        MyDataGrid.DataSource = CreateDataSource()
        MyDataGrid.DataBind()
        ShowStats()
    End Sub 'BindGrid

    Sub ShowStats()
        lblEnabled.Text = "AllowPaging is " & MyDataGrid.AllowPaging
        lblCurrentIndex.Text = "CurrentPageIndex is " & MyDataGrid.CurrentPageIndex
        lblPageCount.Text = "PageCount is " & MyDataGrid.PageCount
        lblPageSize.Text = "PageSize is " & MyDataGrid.PageSize
    End Sub 'ShowStats
   </script>
 
<head runat="server">
    <title>Paging with DataGrid</title>
</head>
<body>
 
   <h3>Paging with DataGrid</h3>
 
   <form id="form1" runat="server">
 
      <asp:DataGrid id="MyDataGrid" runat="server"
           AllowPaging="True"
           PageSize="10"
           PagerStyle-Mode="NumericPages"
           PagerStyle-HorizontalAlign="Right"
           OnPageIndexChanged="MyDataGrid_Page"
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           CellPadding="3"
           CellSpacing="0"
           Font-Names="Verdana"
           Font-Size="8pt"
           HeaderStyle-BackColor="#aaaadd"
           AlternatingItemStyle-BackColor="#eeeeee"/>
 
      <br />
 
      <asp:Checkbox id="chk1" runat="server"
           Text="Show numeric page navigation buttons"
           Font-Names="Verdana"
           Font-Size="8pt"
           AutoPostBack="true"/>
 
      <br />
 
      <table style="background-color:#eeeeee; padding:6">
         <tr>
            <td style="display:inline">
               
 
                  <asp:Label id="lblEnabled" 
                       runat="server"/><br />
                  <asp:Label id="lblCurrentIndex" 
                       runat="server"/><br />
                  <asp:Label id="lblPageCount" 
                       runat="server"/><br />
                  <asp:Label id="lblPageSize" 
                        runat="server"/><br />
 
               
            </td>
         </tr>
      </table>
 
   </form>
 
</body>
</html>

備註

呼叫器是控制項上的 DataGrid 元素，可讓您在啟用分頁時連結到其他頁面。 PagerStyle控制項的 DataGrid 屬性會使用這個類別的實例來代表頁面巡覽器的樣式屬性。

如需分頁的詳細資訊，請參閱 AllowPaging 和 AllowCustomPaging 。

屬性

BackColor	取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 Style)
BorderColor	取得或設定 Web 伺服器控制項的框線色彩。 (繼承來源 Style)
BorderStyle	取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 Style)
BorderWidth	取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 Style)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
CssClass	取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 Style)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
Font	取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 Style)
ForeColor	取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 Style)
Height	取得或設定 Web 伺服器控制項的高度。 (繼承來源 Style)
HorizontalAlign	取得或設定儲存格中內容的水平對齊。 (繼承來源 TableItemStyle)
IsEmpty	保護的 (Protected) 屬性。取得值，指出狀態包中是否已定義任何樣式項目。 (繼承來源 Style)
IsTrackingViewState	傳回值，指出是否任何的樣式項目都已經在狀態包中定義。 (繼承來源 Style)
Mode	取得或設定值，指定頁面巡覽區項目是否顯示連結至上下頁的按鈕，或直接連接至頁面的數值按鈕。
NextPageText	取得或設定顯示於移往下一頁按鈕的文字。
PageButtonCount	取得或設定數值按鈕的數目，以在 DataGrid 控制項的頁面巡覽區項目中同時顯示。
Position	取得或設定在 DataGrid 控制項中頁面巡覽區項目的位置。
PrevPageText	取得或設定顯示於移往上一頁按鈕的文字。
RegisteredCssClass	取得使用控制項註冊的階層式樣式表 (CSS) 類別。 (繼承來源 Style)
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
VerticalAlign	取得或設定儲存格中內容的垂直對齊。 (繼承來源 TableItemStyle)
ViewState	取得保存樣式項目的狀態包。 (繼承來源 Style)
Visible	取得或設定值，指出在 DataGrid 控制項中是否顯示頁面巡覽區。
Width	取得或設定 Web 伺服器控制項的寬度。 (繼承來源 Style)
Wrap	取得或設定值，指出儲存格內容是否在儲存格中換行。 (繼承來源 TableItemStyle)

方法

AddAttributesToRender(HtmlTextWriter)	將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 中。這個方法主要由控制項開發人員使用。 (繼承來源 Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	將水平對齊、垂直對齊和換行的相關資訊加入要呈現的屬性清單。 (繼承來源 TableItemStyle)
CopyFrom(Style)	複製指定 Style 物件的樣式到 DataGridPagerStyle 類別的這個執行個體。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	將指定物件的樣式屬性加入 CssStyleCollection 物件中。 (繼承來源 Style)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetStyleAttributes(IUrlResolutionService)	擷取指定 CssStyleCollection 實作物件的 IUrlResolutionService 物件。 (繼承來源 Style)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
LoadViewState(Object)	載入先前儲存的狀態。 (繼承來源 Style)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
MergeWith(Style)	將指定 Style 物件的樣式與 DataGridPagerStyle 類別的這個執行個體合併。
Reset()	還原 DataGridPagerStyle 物件為它的預設值。
SaveViewState()	保護的 (Protected) 方法。儲存叫用 TrackViewState() 方法之後，任何已變更的狀態。 (繼承來源 Style)
SetBit(Int32)	保護的內部方法。設定內部位元遮罩欄位，表示儲存在狀態包中的樣式屬性。 (繼承來源 Style)
SetDirty()	標記 Style，以便將其狀態記錄在檢視狀態中。 (繼承來源 Style)
ToString()	傳回代表目前物件的字串。 (繼承來源 Style)
TrackViewState()	保護的 (Protected) 方法。在控制項上標記追蹤狀態變更的開頭。任何在追蹤開始後的變更都會被追蹤，並儲存成控制項檢視狀態的一部分。 (繼承來源 Style)

事件

Disposed

當 Dispose() 方法的呼叫處置元件時，就會發生。

(繼承來源 Component)

明確介面實作

IStateManager.IsTrackingViewState	取得值，指出伺服器控制項是否正在追蹤其檢視狀態變更。 (繼承來源 Style)
IStateManager.LoadViewState(Object)	載入先前儲存的狀態。 (繼承來源 Style)
IStateManager.SaveViewState()	傳回包含狀態變更的物件。 (繼承來源 Style)
IStateManager.TrackViewState()	啟動追蹤狀態的變更。 (繼承來源 Style)

適用於

DataGridPagerStyle 類別

定義

範例

備註

屬性

方法

事件

明確介面實作

適用於

另請參閱

意見反應

其他資源