FormView.AllowPaging 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

페이징 기능을 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.

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

속성 값

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 때 발생하지 않습니다.

적용 대상

추가 정보