다음을 통해 공유


DataPager.QueryStringField 속성

정의

쿼리 문자열 필드의 이름을 가져오거나 설정합니다.

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

속성 값

쿼리 문자열 필드의 이름입니다. 기본값은 빈 문자열로, DataPager 컨트롤에서 HTTP POST 명령을 사용하여 페이지를 탐색하게 됨을 나타냅니다.

예제

다음 예제에서는 선언적으로 설정 하는 방법을 보여 줍니다 합니다 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 컨트롤 같은 값으로 연결 된 데이터 바인딩된 컨트롤 매겨집니다 동시에 동일한 쿼리 문자열 필드를 사용 하므로 합니다.

이전 지침을 따르지 않으면 예기치 않은 페이징 동작이 발생할 수 있습니다. 그러나 컨트롤에 의해 예외가 throw 됩니다.

경우 QueryStringField 속성이 빈 문자열이 아닙니다. 또는 null의 값을 ButtonType 속성을 NumericPagerField 또는 NextPreviousPagerField 개체는 무시 됩니다. 이러한 개체 사용 하는 경우는 HyperLink 해당 탐색 단추를 만들기 위해 컨트롤입니다.

적용 대상

추가 정보