다음을 통해 공유

GridView.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 페이징 기능을 GridView 선언적으로 사용 하도록 속성을 사용 하는 방법을 보여 줍니다.


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

설명

데이터 원본의 모든 레코드를 동시에 표시하는 대신 컨트롤에서 GridView 자동으로 레코드를 페이지로 나누면 됩니다. 데이터 원본이 페이징 기능을 지원하는 경우 컨트롤이 GridView 이를 활용하고 기본 제공 페이징 기능을 제공할 수 있습니다. 페이징 기능은 인터페이스를 지원하는 System.Collections.ICollection 모든 데이터 원본 개체 또는 페이징 기능을 지원하는 데이터 원본과 함께 사용할 수 있습니다.

페이징 기능을 사용하도록 설정하려면 속성을 .로 true설정합니다AllowPaging. 기본적으로 컨트롤은 GridView 페이지에 한 번에 10개의 레코드를 표시합니다. 속성을 설정 PageSize 하여 페이지에 표시되는 레코드 수를 변경할 수 있습니다. 데이터 원본 콘텐츠를 표시하는 데 필요한 총 페이지 수를 확인하려면 이 속성을 사용합니다 PageCount . 속성을 사용하여 현재 표시된 페이지의 인덱스 PageIndex 여부를 확인할 수 있습니다.

페이징을 사용하도록 설정하면 호출기 행이라는 추가 행이 컨트롤에 GridView 자동으로 표시됩니다. 호출기 행에는 사용자가 다른 페이지로 이동할 수 있는 컨트롤이 포함되어 있습니다. 속성을 사용하여 PagerSettings 호출기 행의 설정(예: 호출기 표시 모드, 한 번에 표시할 페이지 링크 수 및 호출기 컨트롤의 텍스트 레이블)을 제어할 수 있습니다. 호출기 행은 속성을 설정 Position 하여 컨트롤의 위쪽, 아래쪽 또는 둘 다에 표시될 수 있습니다. 속성을 설정 Mode 하여 기본 제공 페이저 표시 모드 4개 중 하나를 선택할 수도 있습니다. 다음 표에서는 기본 제공 디스플레이 모드에 대해 설명합니다.

Mode Description
PagerButton.NextPrevious 이전 단추와 다음 단추로 구성된 페이지 매김 컨트롤 집합입니다.
PagerButton.NextPreviousFirstLast 이전, 다음, 첫 번째 및 마지막 단추로 구성된 페이지 매김 컨트롤 집합입니다.
PagerButton.Numeric 페이지에 직접 액세스할 수 있는 번호가 매겨진 링크 단추로 구성된 페이지 매김 컨트롤의 집합입니다. 이것이 기본 모드입니다.
PagerButton.NumericFirstLast 번호 매기기 및 첫 번째 및 마지막 링크 단추로 구성된 페이지 매김 컨트롤 집합입니다.

호출기 행의 모양(배경색, 글꼴 색 및 위치 포함)을 제어하려면 이 속성을 사용합니다 PagerStyle .

참고

GridView 데이터 원본에 레코드 페이지가 하나만 포함되어 있으면 컨트롤이 자동으로 호출기 행을 숨깁니다.

또한 컨트롤 GridView 을 사용하면 호출기 행에 대한 사용자 지정 템플릿을 정의할 수 있습니다. 사용자 지정 호출기 행 템플릿을 만드는 방법에 대한 자세한 내용은 다음을 참조하세요 PagerTemplate.

이 컨트롤은 GridView 페이징이 발생할 때 사용자 지정 작업을 수행하는 데 사용할 수 있는 여러 이벤트를 제공합니다. 다음 표에서는 사용 가능한 이벤트를 나열합니다.

이벤트 설명
PageIndexChanged 페이저 단추 중 하나를 클릭하면 GridView 컨트롤이 페이징 작업을 처리한 후에 이 이벤트가 발생합니다. 이 이벤트는 사용자가 컨트롤의 다른 페이지로 이동한 후 작업을 수행해야 하는 경우에 일반적으로 사용됩니다.
PageIndexChanging 페이저 단추 중 하나를 클릭하면 GridView 컨트롤이 페이징 작업을 처리하기 전에 이 이벤트가 발생합니다. 이 이벤트는 페이징 작업을 취소하는 데 자주 사용됩니다.

적용 대상

추가 정보