DataPagerField Sınıf

Tanım

Denetim için gezinti denetimini temsil eden veri çağrı cihazı alan türleri için DataPager temel sınıf görevi görür.

public ref class DataPagerField abstract : System::Web::UI::IStateManager
public abstract class DataPagerField : System.Web.UI.IStateManager
type DataPagerField = class
    interface IStateManager
Public MustInherit Class DataPagerField
Implements IStateManager
Devralma
DataPagerField
Türetilmiş
Uygulamalar

Örnekler

Aşağıdaki örnekte, bir denetimde NextPreviousPagerField sayfa gezinti denetimlerini görüntülemek için , NumericPagerFieldve TemplatePagerField nesnelerinin nasıl kullanılacağı DataPagergösterilmektedir. Nesneler sınıfından DataPagerField türetilir.

<%@ 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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" />
            </b>
            <br /><br />
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td> </td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# IIf(Container.TotalRowCount>0, (Container.StartRowIndex / Container.PageSize) + 1, 0) %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling (System.Convert.ToDouble(Container.TotalRowCount) / Container.PageSize) %>" />
            </b>
            <br /><br />            
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="<<"
            NextPageText=">>"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Açıklamalar

sınıfı, DataPagerField tüm veri çağrı cihazı alan türleri için temel sınıf görevi görür. Veri çağrıları alanları, bir gezinti denetimini temsil etmek için denetim tarafından DataPager kullanılır.

Denetimde hangi tür çağrıyıcının görüntüleneceğini DataPagerField seçmek için türetilen DataPager sınıfları kullanın. Aşağıdaki tabloda kullanılabilir veri sayfalayıcısı alan türleri listelenmiştir.

Pager alan türü Açıklama
NextPreviousPagerField Kullanıcıların her seferinde bir sayfa veri sayfalarında gezinmesine veya ilk veya son sayfaya atlamasına olanak tanır.
NumericPagerField Kullanıcıların sayfa numarasına göre sayfa seçmelerine izin verir.
TemplatePagerField Sayfa geliştiricilerinin özel bir disk belleği kullanıcı arabirimi oluşturmasına olanak tanır.

Ek disk belleği alan türleri oluşturmak için sınıfından DataPagerField türetebilirsiniz.

Uygulayanlara Notlar

sınıfından DataPagerField devraldığınızda, aşağıdaki üyeleri geçersiz kılmanız gerekir:

Oluşturucular

Name Description
DataPagerField()

DataPagerField sınıfının yeni bir örneğini başlatır.

Özellikler

Name Description
DataPager

Nesnenin ilişkili olduğu veri çağrıyıcıya DataPagerField başvuru alır.

IsTrackingViewState

Nesnenin DataPagerField görünüm durumu değişikliklerini izlediğini gösteren bir değer alır.

QueryStringHandled

Sorgu dizesi alanının değerlendirilip değerlendirilmediğini belirten bir değer alır veya ayarlar.

QueryStringValue

İsteğin URL'sinden sorgu dizesi alanının değerini alır.

ViewState

Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenizi ve geri yüklemenizi sağlayan durum DataPagerField bilgileri sözlüğü alır.

Visible

Veri disk belleği alanının işlenip işlenmediğini gösteren bir değer alır veya ayarlar.

Yöntemler

Name Description
CloneField()

öğesinden DataPagerFieldtüretilen geçerli nesnenin bir kopyasını oluşturur.

CopyProperties(DataPagerField)

öğesinden DataPagerField türetilen geçerli nesnenin özelliklerini belirtilen DataPagerField nesneye kopyalar.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, veri disk belleği alanı nesnesi için kullanıcı arabirimi (UI) denetimlerini oluşturur ve bunları belirtilen kapsayıcıya ekler.

CreateField()

Türetilmiş bir sınıfta geçersiz kılındığında, türetilmiş DataPagerFieldboş bir nesne oluşturur.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetQueryStringNavigateUrl(Int32)

Belirtilen sayfa numarasına sahip bir sorgu dizesi alanı içeren bir URL oluşturur.

GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
HandleEvent(CommandEventArgs)

Türetilmiş bir sınıfta geçersiz kılındığında, veri disk belleği alan nesnesinde gerçekleşen olayları işler.

LoadViewState(Object)

Daha önce kaydedilmiş görünüm durumu bilgilerini geri yükler.

MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnFieldChanged()

Olayı tetikler FieldChanged .

SaveViewState()

Nesnenin görünüm durumunda yapılan DataPagerField değişiklikleri kaydeder.

ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
TrackViewState()

Nesnenin görünüm durumundaki DataPagerField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

Belirtik Arabirim Kullanımları

Name Description
IStateManager.IsTrackingViewState

Nesnenin DataPagerField görünüm durumu değişikliklerini izlediğini gösteren bir değer alır.

IStateManager.LoadViewState(Object)

Daha önce kaydedilmiş görünüm durumu bilgilerini geri yükler.

IStateManager.SaveViewState()

Nesnenin görünüm durumunda yapılan DataPagerField değişiklikleri kaydeder.

IStateManager.TrackViewState()

Nesnenin görünüm durumundaki DataPagerField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

Şunlara uygulanır

Ayrıca bkz.