.NET Framework Class Library PagerSettings Class Represents the properties of the paging controls in a control that supports pagination. This class cannot be inherited.
Inheritance Hierarchy
Namespace:
System.Web.UI.WebControls
Assembly:
System.Web (in System.Web.dll)
Syntax
<TypeConverterAttribute(GetType(ExpandableObjectConverter))> _
Public NotInheritable Class PagerSettings _
Implements IStateManager
[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public sealed class PagerSettings : IStateManager
[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public ref class PagerSettings sealed : IStateManager
[<Sealed>]
[<TypeConverterAttribute(typeof(ExpandableObjectConverter))>]
type PagerSettings =
class
interface IStateManager
end
The PagerSettings type exposes the following members.
Constructors
|
| Name | Description |
|---|
.gif) | PagerSettings | Initializes a new instance of the PagerSettings class. |
Top
Methods
Events
|
| Name | Description |
|---|
.gif) | PropertyChanged | Occurs when a property of a PagerSettings object changes values. |
Top
Explicit Interface Implementations
Remarks
Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. The PagerSettings class is used by these controls to represent the properties of the pager. In general, the PagerSettings object is stored in the PagerSettings property of the control. You can customize the pager by setting the properties of the PagerSettings object. The pager supports several different display modes. To specify the mode in which to display the pager, set the Mode property. The following table describes the different modes. Mode | Description |
|---|
NextPrevious | Previous-page and next-page buttons. | NextPreviousFirstLast | Previous-page, next-page, first-page, and last -page buttons. | Numeric | Numbered link buttons to access pages directly. | NumericFirstLast | Numbered-link, first-link, and last-link buttons. |
When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table. As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table. .gif) Note |
|---|
When an image property is set, the corresponding text property acts as the alternate text for the image. For example, when the FirstPageImageUrl property is set, the text that is specified by the FirstPageText property is displayed as the alternate text for the image. On browsers that support ToolTips, this text is also displayed as a ToolTip for the corresponding button. |
When the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property. The pager can be displayed at the top, the bottom, or both the top and bottom of a control. To specify the position of the pager, set the Position property. To show or hide the pager, use the Visible property.
Examples
The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a GridView control.
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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>
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
|
Bibliothèque de classes .NET Framework PagerSettings, classe Représente les propriétés des contrôles de pagination dans un contrôle qui prend en charge la pagination. Cette classe ne peut pas être héritée.
Hiérarchie d'héritage
Espace de noms :
System.Web.UI.WebControls
Assembly :
System.Web (dans System.Web.dll)
Syntaxe
<TypeConverterAttribute(GetType(ExpandableObjectConverter))> _
Public NotInheritable Class PagerSettings _
Implements IStateManager
[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public sealed class PagerSettings : IStateManager
[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public ref class PagerSettings sealed : IStateManager
[<Sealed>]
[<TypeConverterAttribute(typeof(ExpandableObjectConverter))>]
type PagerSettings =
class
interface IStateManager
end
Le type PagerSettings expose les membres suivants.
Constructeurs
|
| Nom | Description |
|---|
| PagerSettings | Initialise une nouvelle instance de la classe PagerSettings. |
Début
Méthodes
Événements
|
| Nom | Description |
|---|
| PropertyChanged | Se produit lorsqu'une propriété d'un objet PagerSettings modifie des valeurs. |
Début
Implémentations d'interface explicite
Notes
Les contrôles qui prennent en charge la pagination (tels que les contrôles GridView, DetailsView et FormView) peuvent afficher un ensemble de contrôles appelé le pagineur qui permet à l'utilisateur de parcourir les pages du contrôle. La classe PagerSettings est utilisée par ces contrôles pour représenter les propriétés du pagineur. En général, l'objet PagerSettings est stocké dans la propriété PagerSettings du contrôle. Vous pouvez personnaliser le pagineur en définissant les propriétés de l'objet PagerSettings. Le pagineur prend en charge différents modes d'affichage. Pour spécifier le mode dans lequel afficher le pagineur, définissez la propriété Mode. Le tableau suivant décrit les différents modes. Mode | Description |
|---|
NextPrevious | Boutons de page précédente et de page suivante. | NextPreviousFirstLast | Boutons de page précédente, de page suivante, de première page et de dernière page. | Numeric | Boutons de lien numérotés pour accéder directement aux pages. | NumericFirstLast | Boutons de lien numérotés, de premier lien et de dernier lien. |
Lorsque la propriété Mode a la valeur NextPrevious NextPreviousFirstLast ou NumericFirstLast, vous pouvez personnaliser le texte des boutons non numérotés en définissant les propriétés affichées dans le tableau suivant. Une autre possibilité consiste à afficher des images de boutons non numérotés en définissant les propriétés comme indiqué dans le tableau suivant. | Remarque |
|---|
Lorsqu'une propriété d'image est définie, la propriété Text correspondante agit en tant que texte de remplacement pour l'image. Par exemple, lorsque la propriété FirstPageImageUrl est définie, le texte spécifié par la propriété FirstPageText est affiché en tant que texte de remplacement pour l'image. Dans les navigateurs qui prennent en charge la fonctionnalité Info-bulles, ce texte s'affiche également sous forme d'info-bulle pour le bouton correspondant. |
Lorsque la propriété Mode a la valeur Numeric ou NumericFirstLast, vous pouvez spécifier le nombre de boutons de page à afficher dans le pagineur en définissant la propriété PageButtonCount. Le pagineur peut être affiché en haut, en bas ou en haut et en bas d'un contrôle. Pour spécifier la position du pagineur, définissez la propriété Position. Pour afficher ou masquer le pagineur, utilisez la propriété Visible.
Exemples
L'exemple de code suivant illustre l'utilisation de l'objet PagerSettings contenu dans la propriété PagerSettings pour personnaliser le texte des boutons affichés dans la ligne de pagineur d'un contrôle GridView.
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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>
Informations de version
.NET FrameworkPris en charge dans : 4, 3.5, 3.0, 2.0
Plateformes
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads
Tous les membres static ( Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi
|