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присвоено значение или NextPreviousFirstLastNumericFirstLast значение, можно указать пользовательский текст для нечисловых кнопок, задав свойства, показанные в следующей таблице.

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

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

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

Примечание

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

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

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

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