다음을 통해 공유


PagerSettings 클래스

정의

페이지 매김을 지원하는 컨트롤에서 페이징 컨트롤의 속성을 나타냅니다. 이 클래스는 상속할 수 없습니다.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
상속
PagerSettings
특성
구현

예제

다음 코드 예제에서는 컨트롤의 PagerSettings 호출기 행에 PagerSettings 표시 되는 단추의 텍스트를 사용자 지정 하는 속성에 포함 된 개체를 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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

설명

페이지 매김을 지원하는 컨트롤(예: GridView, DetailsViewFormView 컨트롤)은 사용자가 컨트롤 내의 페이지를 탐색할 수 있도록 하는 호출기 라는 컨트롤 집합을 표시할 수 있습니다. 이 PagerSettings 클래스는 이러한 컨트롤에서 호출기의 속성을 나타내는 데 사용됩니다. 일반적으로 개체는 PagerSettings 컨트롤의 속성에 PagerSettings 저장됩니다. 개체의 PagerSettings 속성을 설정하여 호출기를 사용자 지정할 수 있습니다.

호출기에서 여러 가지 표시 모드를 지원합니다. 호출기를 표시할 모드를 지정하려면 속성을 설정합니다 Mode . 다음 표에서는 다양한 모드에 대해 설명합니다.

모드 설명
NextPrevious 이전 페이지 및 다음 페이지 단추.
NextPreviousFirstLast 이전 페이지, 다음 페이지, 첫 페이지 및 마지막 -page 단추입니다.
Numeric 페이지에 직접 액세스하기 위한 번호가 매겨진 링크 단추입니다.
NumericFirstLast 번호가 매겨진 링크, 첫 번째 링크 및 마지막 링크 단추입니다.

속성이 ModeNextPreviousNextPreviousFirstLast또는 NumericFirstLast 값으로 설정된 경우 다음 표에 표시된 속성을 설정하여 숫자가 아닌 단추의 텍스트를 사용자 지정할 수 있습니다.

재산 설명
FirstPageText 첫 페이지 단추의 텍스트입니다.
PreviousPageText 이전 페이지 단추에 대한 텍스트입니다.
NextPageText 다음 페이지 단추에 대한 텍스트입니다.
LastPageText 마지막 페이지 단추의 텍스트입니다.

또는 다음 표와 같이 속성을 설정하여 숫자가 아닌 단추에 대한 이미지를 표시할 수도 있습니다.

재산 설명
FirstPageImageUrl 첫 번째 페이지 단추에 대해 표시할 이미지의 URL입니다.
PreviousPageImageUrl 이전 페이지 단추에 대해 표시할 이미지의 URL입니다.
NextPageImageUrl 다음 페이지 단추에 대해 표시할 이미지의 URL입니다.
LastPageImageUrl 마지막 페이지 단추에 대해 표시할 이미지의 URL입니다.

메모

이미지 속성이 설정되면 해당 텍스트 속성이 이미지의 대체 텍스트 역할을 합니다. 예를 들어 속성이 FirstPageImageUrl 설정되면 속성에 FirstPageText 지정된 텍스트가 이미지의 대체 텍스트로 표시됩니다. 도구 설명을 지원하는 브라우저에서 이 텍스트는 해당 단추에 대한 도구 설명으로도 표시됩니다.

속성이 Mode 값 또는 NumericFirstLast 값으로 Numeric 설정되면 속성을 설정 PageButtonCount 하여 호출기에서 표시할 페이지 단추 수를 지정할 수 있습니다.

호출기를 컨트롤의 위쪽, 아래쪽 또는 위쪽과 아래쪽 모두에 표시할 수 있습니다. 호출기의 위치를 지정하려면 속성을 설정합니다 Position . 호출기를 표시하거나 숨기려면 속성을 사용합니다 Visible .

생성자

Name Description
PagerSettings()

PagerSettings 클래스의 새 인스턴스를 초기화합니다.

속성

Name Description
FirstPageImageUrl

첫 페이지 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다.

FirstPageText

첫 페이지 단추에 표시할 텍스트를 가져오거나 설정합니다.

LastPageImageUrl

마지막 페이지 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다.

LastPageText

마지막 페이지 단추에 표시할 텍스트를 가져오거나 설정합니다.

Mode

페이지 매김을 지원하는 컨트롤에 페이저 컨트롤을 표시할 모드를 가져오거나 설정합니다.

NextPageImageUrl

다음 페이지 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다.

NextPageText

다음 페이지 단추에 대해 표시할 텍스트를 가져오거나 설정합니다.

PageButtonCount

속성이 값으로 설정된 경우 Mode 호출기에서 표시할 페이지 단추 수를 Numeric 가져오거나 NumericFirstLast 설정합니다.

Position

호출기가 표시되는 위치를 지정하는 값을 가져오거나 설정합니다.

PreviousPageImageUrl

이전 페이지 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다.

PreviousPageText

이전 페이지 단추에 대해 표시할 텍스트를 가져오거나 설정합니다.

Visible

페이징 컨트롤이 페이지 매김을 지원하는 컨트롤에 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Name Description
Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

개체의 문자열 표현을 검색 PagerSettings 합니다.

이벤트

Name Description
PropertyChanged

개체의 PagerSettings 속성이 값을 변경할 때 발생합니다.

명시적 인터페이스 구현

Name Description
IStateManager.IsTrackingViewState

서버 컨트롤이 뷰 상태 변경 내용을 추적하고 있는지 여부를 나타내는 값을 가져옵니다.

IStateManager.LoadViewState(Object)

개체의 이전에 저장된 뷰 상태를 로드합니다 PagerSettings .

IStateManager.SaveViewState()

개체의 현재 뷰 상태를 PagerSettings 저장합니다.

IStateManager.TrackViewState()

개체에 대한 뷰 상태 변경 내용 추적 및 저장을 PagerSettings 시작할 시작 지점을 표시합니다.

적용 대상

추가 정보