Поделиться через

PagerSettings.Mode Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает режим, в котором отображаются элементы управления пейджера в элементе управления, поддерживающем разбиение на страницы.

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

Значение свойства

PagerButtons

Одно из значений PagerButtons . Значение по умолчанию — PagerButtons.Numeric.

Исключения

ArgumentOutOfRangeException

Для Mode параметра задано значение, которое не является одним из значений PagerButtons .

Примеры

В следующем примере кода показано, как использовать Mode свойство, чтобы указать, что строка пейджера для 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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

Комментарии

Элементы управления, поддерживающие разбиение на страницы, предоставляют несколько режимов, в которых отображаются элементы управления разбиением на страницы. Mode Используйте свойство, чтобы указать режим. В следующей таблице описаны различные режимы для элементов управления разбивкой на страницы.

Режим Описание
NextPrevious Кнопки предыдущей страницы и следующей страницы.
NextPreviousFirstLast Кнопки предыдущей страницы, следующей страницы, первой страницы и последней страницы.
Numeric Нумерованные кнопки ссылки для прямого доступа к страницам.
NumericFirstLast Нумерованные и кнопки последней ссылки.

Mode Если для свойства задано NextPreviousзначение , NextPreviousFirstLastили NumericFirstLast значение, можно указать пользовательский текст для нечисловых кнопок, задав свойства, показанные в следующей таблице.

Недвижимость Описание
FirstPageText Текст для кнопки первой страницы.
PreviousPageText Текст для кнопки предыдущей страницы.
NextPageText Текст для кнопки следующей страницы.
LastPageText Текст для кнопки последней страницы.

В качестве альтернативы можно также отображать изображения для нечисловых кнопок, задав свойства, показанные в следующей таблице.

Недвижимость Описание
FirstPageImageUrl URL-адрес изображения, отображаемого для кнопки первой страницы.
PreviousPageImageUrl URL-адрес изображения, отображаемого для кнопки предыдущей страницы.
NextPageImageUrl URL-адрес изображения, отображаемого для кнопки следующей страницы.
LastPageImageUrl URL-адрес изображения, отображаемого для кнопки последней страницы.

Замечание

Если задано свойство изображения, соответствующее текстовое свойство выступает в качестве альтернативного текста для изображения. Например, если FirstPageImageUrl свойство задано, текст, указанный FirstPageText свойством, отображается в качестве альтернативного текста для изображения. В браузерах, поддерживающих подсказки, этот текст также отображается в виде подсказки для соответствующей кнопки.

Значение этого свойства хранится в состоянии представления.

Применяется к

См. также раздел