GridView.PagerSettings Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un riferimento all'oggetto PagerSettings che consente di impostare le proprietà dei pulsanti di spostamento in un controllo GridView.
public:
virtual property System::Web::UI::WebControls::PagerSettings ^ PagerSettings { System::Web::UI::WebControls::PagerSettings ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.PagerSettings PagerSettings { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.PagerSettings : System.Web.UI.WebControls.PagerSettings
Public Overridable ReadOnly Property PagerSettings As PagerSettings
Valore della proprietà
Riferimento a PagerSettings che consente di impostare le proprietà dei pulsanti di spostamento in un controllo GridView.
- Attributi
Esempio
Nell'esempio seguente viene illustrato come impostare la PagerSettings proprietà in modo dichiarativo. Imposta rispettivamente il tipo di carattere e lo sfondo per la riga del cercapersone su blu e blu chiaro.
<%@ 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>
Commenti
Utilizzare la PagerSettings proprietà per controllare le impostazioni della riga del cercapersone in un GridView controllo . La riga del cercapersone viene visualizzata quando la funzionalità di paging è abilitata (impostando la AllowPaging proprietà su true
) e contiene i controlli che consentono all'utente di passare alle diverse pagine del controllo. Questa proprietà è di sola lettura; Tuttavia, è possibile impostare le proprietà dell'oggetto PagerSettings restituito. Le proprietà possono essere impostate in modo dichiarativo usando uno dei metodi seguenti:
Inserire un attributo nel tag di apertura del GridView controllo nel formato
Property-Subproperty
, doveSubproperty
è una proprietà dell'oggetto PagerSettings , ad esempioPagerSettings-Mode
.Annidare un
<PagerSettings>
elemento tra i tag di apertura e chiusura del GridView controllo.
Le proprietà possono anche essere impostate a livello di codice nel modulo Property.Subproperty
, ad esempio PagerStyle.Mode
. Le impostazioni comuni includono in genere la modalità di visualizzazione della riga del cercapersone e il testo o le immagini personalizzati per i controlli di spostamento.