DataPager.QueryStringField Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Sorgu dizesi alanının adını alır veya ayarlar.

public:
 property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };

[System.Web.WebCategory("Paging")]
public string QueryStringField { get; set; }

[<System.Web.WebCategory("Paging")>]
member this.QueryStringField : string with get, set

Public Property QueryStringField As String

Özellik Değeri

String

Sorgu dizesi alanının adı. Varsayılan, denetimin DataPager sayfalarda gezinmek için bir HTTP POST komutu kullanacağını gösteren boş bir dizedir.

Öznitelikler: WebCategoryAttribute

Örnekler

Aşağıdaki örnekte, bir sorgu dizesi kullanarak sayfalarda gezinmek için denetimdeki DataPager özelliğin bildirim temelli olarak nasıl ayarlanacağı QueryStringField gösterilmektedir. Bu örnek, tek ListView bir denetim tarafından görüntülenen veriler arasında sayfalandırmak için kullanılan iki DataPager denetim içerir.

<%@ 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>DataPager Example</title>
    <style type="text/css">
      th
      {
        background-color:#eef4fa;
        border-top:solid 1px #9dbbcc;
        border-bottom:solid 1px #9dbbcc;
      }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataPager QueryStringField Example</h3>
      
      <asp:DataPager runat="server" ID="DataPager1"
        PagedControlID="CountriesListView" 
        QueryStringField="pageNumber">
        <Fields>
          <asp:NumericPagerField />
        </Fields>
      </asp:DataPager>
      <br /><br />

      <asp:ListView ID="CountriesListView" 
        DataSourceID="CountryDataSource"
        runat="server" >
        <LayoutTemplate>
          <table cellpadding="4" width="500" runat="server" id="tblCountries">
            <tr runat="server">
              <th runat="server">Code</th>
              <th runat="server">Name</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr>
            <td>
              <asp:Label ID="CountryCodeLabel" runat="server" 
                Text='<%# Eval("CountryRegionCode")%>' />
            </td>          
            <td>
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%# Eval("Name")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <!-- The second DataPager control. -->
      <asp:DataPager runat="server" ID="DataPager2"
        PagedControlID="CountriesListView" 
        QueryStringField="pageNumber">
        <Fields>
          <asp:NumericPagerField />
        </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="CountryDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [CountryRegionCode], [Name]
          FROM [Person].[CountryRegion]">
      </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>DataPager Example</title>
    <style type="text/css">
      th
      {
        background-color:#eef4fa;
        border-top:solid 1px #9dbbcc;
        border-bottom:solid 1px #9dbbcc;
      }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataPager QueryStringField Example</h3>
      
      <asp:DataPager runat="server" ID="DataPager1"
        PagedControlID="CountriesListView" 
        QueryStringField="pageNumber">
        <Fields>
          <asp:NumericPagerField />
        </Fields>
      </asp:DataPager>
      <br /><br />

      <asp:ListView ID="CountriesListView" 
        DataSourceID="CountryDataSource"
        runat="server" >
        <LayoutTemplate>
          <table cellpadding="4" width="500" runat="server" id="tblCountries">
            <tr runat="server">
              <th runat="server">Code</th>
              <th runat="server">Name</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr>
            <td>
              <asp:Label ID="CountryCodeLabel" runat="server" 
                Text='<%# Eval("CountryRegionCode")%>' />
            </td>          
            <td>
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%# Eval("Name")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <!-- The second DataPager control. -->
      <asp:DataPager runat="server" ID="DataPager2"
        PagedControlID="CountriesListView" 
        QueryStringField="pageNumber">
        <Fields>
          <asp:NumericPagerField />
        </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="CountryDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [CountryRegionCode], [Name]
          FROM [Person].[CountryRegion]">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Açıklamalar

Denetimin QueryStringField DataPager sayfalarda gezinmek için bir HTTP GET komutu kullandığını belirtmek için özelliğini kullanın. GET isteklerinde, sayfanın URL'sine bir ad/değer çifti içeren bir sorgu dizesi alanı eklenir. Ad özelliği kullanılarak QueryStringField ayarlanır. Değer, karşılık gelen sayfa numarasıdır. boş bir dize veya nulliseQueryStringField, denetim sayfalarda gezinmek için bir HTTP POST komutu kullanır.

Bu özelliği ayarlamak, tüm veri sayfalarının bir arama altyapısı tarafından dizine eklenmesini istiyorsanız kullanışlıdır. Bu durum, denetimin her veri sayfası için farklı bir URL üretmesi nedeniyle oluşur.

Özelliğini ayarladığınızda QueryStringField aşağıdaki koşullar geçerli olabilir:

Sayfada birden DataPager fazla denetiminiz var ve bunlar aynı veriye bağlı denetime başvuruda bulunur. Bu durumda, bu DataPager denetimlerin QueryStringField özelliğinin aynı değere ayarlandığından emin olun.
Sayfada birden DataPager fazla denetiminiz var ve bunlar farklı veriye bağlı denetimlere başvuruda bulunur. Bu durumda, bu DataPager denetimlerin QueryStringField özelliğinin farklı değerlere ayarlandığından emin olun. Denetimleri aynı değere ayarlarsanız DataPager , ilişkili veriye bağlı denetimler aynı sorgu dizesi alanını kullanacakları için aynı anda sayfalandırılır.

Önceki yönergeleri izlemezseniz beklenmeyen disk belleği davranışı oluşabilir. Ancak, denetim tarafından hiçbir özel durum oluşturulmayacak.

Özellik boş bir dize veya değilseQueryStringField, nullveya NextPreviousPagerField nesnelerinin özelliğinin ButtonType NumericPagerField değeri yoksayılır. Bu durumda, bu nesneler gezinti düğmelerini oluşturmak için denetimini kullanır HyperLink .

Şunlara uygulanır