FormView.AllowPaging 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
페이징 기능을 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.
public:
virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean
속성 값
페이징 기능을 사용하는 경우 true
이고, 그렇지 않으면 false
입니다. 기본값은 false
입니다.
예제
다음 예제에서는 컨트롤에서 AllowPaging 페이징 기능을 FormView 사용 하도록 속성을 사용 하는 방법을 보여 줍니다.
<%@ 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 runat="server">
<title>FormView AllowPaging Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView AllowPaging Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"/>
<pagerstyle backcolor="LightBlue"
horizontalalign="Center"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
</asp:formview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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 runat="server">
<title>FormView AllowPaging Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView AllowPaging Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"/>
<pagerstyle backcolor="LightBlue"
horizontalalign="Center"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
</asp:formview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
설명
컨트롤에는 FormView 사용자가 데이터 원본의 다른 레코드로 이동할 수 있는 기본 제공 페이징 기능이 있습니다. 페이징 기능은 인터페이스를 지원하는 System.Collections.ICollection 모든 데이터 원본 개체 또는 페이징 기능을 지원하는 데이터 원본과 함께 사용할 수 있습니다.
페이징 기능을 사용하려면 속성을 true
.로 설정합니다AllowPaging. 속성을 사용하여 PageCount 기본 데이터 원본의 총 항목 수를 확인할 수 있습니다. 현재 표시된 항목의 인덱스 확인 하려면 속성을 사용 합니다 PageIndex .
페이징을 사용하도록 설정하면 호출기 행이라는 추가 행이 컨트롤에 FormView 자동으로 표시됩니다. 호출기 행에는 페이지 탐색 컨트롤이 포함되어 있으며 컨트롤의 위쪽, 아래쪽 또는 위쪽과 아래쪽에 모두 표시될 수 있습니다. 호출기 행에는 네 가지 기본 제공 호출기 표시 모드가 있습니다. 다음 표에서는 네 가지 모드에 대해 설명합니다.
Mode | Description |
---|---|
PagerButton.NextPrevious |
이전 단추와 다음 단추로 구성된 페이지 매김 컨트롤 집합입니다. |
PagerButton.NextPreviousFirstLast |
이전, 다음, 첫 번째 및 마지막 단추로 구성된 페이지 매김 컨트롤 집합입니다. |
PagerButton.Numeric |
페이지에 직접 액세스할 수 있는 번호가 매겨진 링크 단추로 구성된 페이지 매김 컨트롤의 집합입니다. 이것이 기본 모드입니다. |
PagerButton.NumericFirstLast |
번호 매기기 및 첫 번째 및 마지막 링크 단추로 구성된 페이지 매김 컨트롤 집합입니다. |
참고
FormView 데이터 원본에 두 개 미만의 레코드가 포함된 경우 컨트롤은 자동으로 호출기 행을 숨깁니다.
속성을 사용하여 호출기 행의 설정(예: 호출기 표시 모드, 한 번에 표시할 페이지 링크 수 및 호출기 컨트롤의 텍스트 레이블)을 PagerSettings 제어할 수 있습니다. 페이저 행의 모양(배경색 및 글꼴 색 포함)을 제어하려면 이 속성을 사용합니다 PagerStyle . 또한 이 FormView 컨트롤을 사용하면 호출기 행에 대한 사용자 지정 템플릿을 정의할 수 있습니다. 사용자 지정 호출기 행 템플릿을 만드는 방법에 대한 자세한 내용은 다음을 참조하세요 PagerTemplate.
이 컨트롤은 FormView 페이징이 발생할 때 사용자 지정 작업을 수행하는 데 사용할 수 있는 여러 이벤트를 제공합니다. 다음 표에서는 사용 가능한 이벤트를 나열합니다.
이벤트 | 설명 |
---|---|
PageIndexChanged | 페이저 단추 중 하나를 클릭하면 FormView 컨트롤이 페이징 작업을 처리한 후에 이 이벤트가 발생합니다. 이 이벤트는 사용자가 컨트롤의 다른 레코드로 이동한 후 작업을 수행해야 하는 경우에 일반적으로 사용됩니다. |
PageIndexChanging | 페이저 단추 중 하나를 클릭하면 FormView 컨트롤이 페이징 작업을 처리하기 전에 이 이벤트가 발생합니다. 이 이벤트는 페이징 작업을 취소하는 데 자주 사용됩니다. |
참고
이러한 이벤트는 속성을 프로그래밍 방식으로 변경할 PageIndex 때 발생하지 않습니다.