DataPager.QueryStringField 屬性

參考

定義

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

組件:: System.Web.Extensions.dll

重要

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

取得或設定查詢字串欄位的名稱。

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

屬性值

String

查詢字串欄位的名稱。預設值是空字串，表示 DataPager 控制項會使用 HTTP POST 命令來巡覽頁面。

屬性: WebCategoryAttribute

範例

下列範例示範如何使用查詢字串，以宣告方式設定 QueryStringField 控制項中的 DataPager 屬性，以巡覽頁面。此範例包含兩 DataPager 個控制項，可用來逐頁查看單 ListView 一控制項所顯示的資料。

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

備註

QueryStringField使用屬性來 DataPager 指定控制項使用 HTTP GET 命令來巡覽頁面。在 GET 要求中，包含名稱/值組的查詢字串欄位會新增至頁面的 URL。名稱是使用屬性來 QueryStringField 設定。此值是對應的頁碼。如果 QueryStringField 是空字串或 null ，則控制項會使用 HTTP POST 命令來巡覽頁面。

如果您想要讓搜尋引擎編制索引的所有資料頁面，則設定此屬性很有用。這是因為控制項會針對每個資料頁面產生不同的 URL。

當您設定屬性時 QueryStringField ，可能會套用下列條件：

您在頁面中有多個 DataPager 控制項，而且它們會參考相同的資料繫結控制項。在此情況下，請確定 QueryStringField 這些 DataPager 控制項的屬性設定為相同的值。
您在頁面中有多個 DataPager 控制項，而且它們會參考不同的資料繫結控制項。在此情況下，請確定 QueryStringField 這些 DataPager 控制項的屬性設定為不同的值。如果您將 DataPager 控制項設定為相同的值，相關聯的資料繫結控制項將會同時編頁，因為它們會使用相同的查詢字串欄位。

如果您未遵循先前的指導方針，可能會發生非預期的分頁行為。不過，控制項不會擲回例外狀況。

如果 QueryStringField property 不是空字串或 null ，則會 ButtonType 忽略或 NextPreviousPagerField 物件的屬性值 NumericPagerField 。在此情況下，這些物件會 HyperLink 使用控制項來建立其瀏覽按鈕。

適用於

共用方式為

DataPager.QueryStringField 屬性

定義

屬性值

範例

備註

適用於

另請參閱

其他資源