Aracılığıyla paylaş


DataPager.QueryStringField Özellik

Tanım

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

public:
 property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };
public string QueryStringField { get; set; }
member this.QueryStringField : string with get, set
Public Property QueryStringField As String

Özellik Değeri

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.

Ö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 QueryStringFieldDataPager 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 ButtonTypeNumericPagerField değeri yoksayılır. Bu durumda, bu nesneler gezinti düğmelerini oluşturmak için denetimini kullanır HyperLink .

Şunlara uygulanır

Ayrıca bkz.