DataPager.QueryStringField 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. 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, setPublic Property QueryStringField As 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 컨트롤 같은 값으로 연결 된 데이터 바인딩된 컨트롤 매겨집니다 동시에 동일한 쿼리 문자열 필드를 사용 하므로 합니다.
이전 지침을 따르지 않으면 예기치 않은 페이징 동작이 발생할 수 있습니다. 그러나 컨트롤에 의해 예외가 throw 됩니다.
경우 QueryStringField 속성이 빈 문자열이 아닙니다. 또는 null의 값을 ButtonType 속성을 NumericPagerField 또는 NextPreviousPagerField 개체는 무시 됩니다. 이러한 개체 사용 하는 경우는 HyperLink 해당 탐색 단추를 만들기 위해 컨트롤입니다.