DataGridPagerStyle Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Formatvorlage für den Pager des DataGrid Steuerelements an. Diese Klasse kann nicht vererbt werden.
public ref class DataGridPagerStyle sealed : System::Web::UI::WebControls::TableItemStyle
public sealed class DataGridPagerStyle : System.Web.UI.WebControls.TableItemStyle
type DataGridPagerStyle = class
inherit TableItemStyle
Public NotInheritable Class DataGridPagerStyle
Inherits TableItemStyle
- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein DataGridPagerStyle Objekt verwendet wird, um die Formatvorlage des Pager-Elements in der PagerStyle Eigenschaft darzustellen. Das DataGridPagerStyle Objekt legt den Anzeigemodus und die Ausrichtung des Paging-Elements fest.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script language="C#" runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("DateTimeValue", typeof(string)));
dt.Columns.Add(new DataColumn("BoolValue", typeof(bool)));
for (int i = 0; i < 100; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Item " + i.ToString();
dr[2] = DateTime.Now.ToShortDateString();
dr[3] = (i % 2 != 0) ? true : false;
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
if (chk1.Checked)
MyDataGrid.PagerStyle.Mode = PagerMode.NumericPages;
else
MyDataGrid.PagerStyle.Mode = PagerMode.NextPrev;
BindGrid();
}
void MyDataGrid_Page(Object sender, DataGridPageChangedEventArgs e)
{
MyDataGrid.CurrentPageIndex = e.NewPageIndex;
BindGrid();
}
void BindGrid()
{
MyDataGrid.DataSource = CreateDataSource();
MyDataGrid.DataBind();
ShowStats();
}
void ShowStats()
{
lblEnabled.Text = "AllowPaging is " + MyDataGrid.AllowPaging;
lblCurrentIndex.Text = "CurrentPageIndex is " + MyDataGrid.CurrentPageIndex;
lblPageCount.Text = "PageCount is " + MyDataGrid.PageCount;
lblPageSize.Text = "PageSize is " + MyDataGrid.PageSize;
}
</script>
<head runat="server">
<title>Paging with DataGrid</title>
</head>
<body>
<h3>Paging with DataGrid</h3>
<form id="form1" runat="server">
<asp:DataGrid id="MyDataGrid" runat="server"
AllowPaging="True"
PageSize="10"
PagerStyle-Mode="NumericPages"
PagerStyle-HorizontalAlign="Right"
OnPageIndexChanged="MyDataGrid_Page"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
CellPadding="3"
CellSpacing="0"
Font-Names="Verdana"
Font-Size="8pt"
HeaderStyle-BackColor="#aaaadd"
AlternatingItemStyle-BackColor="#eeeeee"/>
<br />
<asp:Checkbox id="chk1" runat="server"
Text="Show numeric page navigation buttons"
Font-Names="Verdana"
Font-Size="8pt"
AutoPostBack="true"/>
<br />
<table style="background-color:#eeeeee; padding:6">
<tr>
<td style="display:inline">
<asp:Label id="lblEnabled"
runat="server"/><br />
<asp:Label id="lblCurrentIndex"
runat="server"/><br />
<asp:Label id="lblPageCount"
runat="server"/><br />
<asp:Label id="lblPageSize"
runat="server"/><br />
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script language="VB" runat="server">
Function CreateDataSource() As ICollection
Dim dt As New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("DateTimeValue", GetType(String)))
dt.Columns.Add(New DataColumn("BoolValue", GetType(Boolean)))
Dim i As Integer
For i = 0 To 99
dr = dt.NewRow()
dr(0) = i
dr(1) = "Item " & i.ToString()
dr(2) = DateTime.Now.ToShortDateString()
If i Mod 2 <> 0 Then
dr(3) = True
Else
dr(3) = False
End If
dt.Rows.Add(dr)
Next i
Dim dv As New DataView(dt)
Return dv
End Function 'CreateDataSource
Sub Page_Load(sender As Object, e As EventArgs)
If chk1.Checked Then
MyDataGrid.PagerStyle.Mode = PagerMode.NumericPages
Else
MyDataGrid.PagerStyle.Mode = PagerMode.NextPrev
End If
BindGrid()
End Sub 'Page_Load
Sub MyDataGrid_Page(sender As Object, e As DataGridPageChangedEventArgs)
MyDataGrid.CurrentPageIndex = e.NewPageIndex
BindGrid()
End Sub 'MyDataGrid_Page
Sub BindGrid()
MyDataGrid.DataSource = CreateDataSource()
MyDataGrid.DataBind()
ShowStats()
End Sub 'BindGrid
Sub ShowStats()
lblEnabled.Text = "AllowPaging is " & MyDataGrid.AllowPaging
lblCurrentIndex.Text = "CurrentPageIndex is " & MyDataGrid.CurrentPageIndex
lblPageCount.Text = "PageCount is " & MyDataGrid.PageCount
lblPageSize.Text = "PageSize is " & MyDataGrid.PageSize
End Sub 'ShowStats
</script>
<head runat="server">
<title>Paging with DataGrid</title>
</head>
<body>
<h3>Paging with DataGrid</h3>
<form id="form1" runat="server">
<asp:DataGrid id="MyDataGrid" runat="server"
AllowPaging="True"
PageSize="10"
PagerStyle-Mode="NumericPages"
PagerStyle-HorizontalAlign="Right"
OnPageIndexChanged="MyDataGrid_Page"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
CellPadding="3"
CellSpacing="0"
Font-Names="Verdana"
Font-Size="8pt"
HeaderStyle-BackColor="#aaaadd"
AlternatingItemStyle-BackColor="#eeeeee"/>
<br />
<asp:Checkbox id="chk1" runat="server"
Text="Show numeric page navigation buttons"
Font-Names="Verdana"
Font-Size="8pt"
AutoPostBack="true"/>
<br />
<table style="background-color:#eeeeee; padding:6">
<tr>
<td style="display:inline">
<asp:Label id="lblEnabled"
runat="server"/><br />
<asp:Label id="lblCurrentIndex"
runat="server"/><br />
<asp:Label id="lblPageCount"
runat="server"/><br />
<asp:Label id="lblPageSize"
runat="server"/><br />
</td>
</tr>
</table>
</form>
</body>
</html>
Hinweise
Der Pager ist ein Element im Steuerelement, mit dem DataGrid Sie beim Aktivieren der Seitenverwaltung eine Verknüpfung mit anderen Seiten herstellen können. Die PagerStyle Eigenschaft des DataGrid Steuerelements verwendet eine Instanz dieser Klasse, um die Formateigenschaften für den Pager darzustellen.
Weitere Informationen zum Paging finden Sie unter AllowPaging und AllowCustomPaging.
Eigenschaften
| Name | Beschreibung |
|---|---|
| BackColor |
Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von Style) |
| BorderColor |
Ruft die Rahmenfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style) |
| BorderStyle |
Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von Style) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style) |
| CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
| Container |
Ruft das, das IContainer die Component. (Geerbt von Component) |
| CssClass |
Ruft die css-Klasse (Cascading Stylesheet) ab, die vom Webserversteuerelement auf dem Client gerendert wird, oder legt sie fest. (Geerbt von Style) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component) |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von Style) |
| ForeColor |
Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von Style) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von Style) |
| HorizontalAlign |
Ruft die horizontale Ausrichtung des Inhalts in einer Zelle ab oder legt sie fest. (Geerbt von TableItemStyle) |
| IsEmpty |
Eine geschützte Eigenschaft. Ruft einen Wert ab, der angibt, ob Stilelemente im Zustandsbehälter definiert wurden. (Geerbt von Style) |
| IsTrackingViewState |
Gibt einen Wert zurück, der angibt, ob elemente im Zustandsbehälter definiert wurden. (Geerbt von Style) |
| Mode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Pager-Element Schaltflächen anzeigt, die mit der nächsten und vorherigen Seite verknüpft sind, oder numerische Schaltflächen, die direkt mit einer Seite verknüpft sind. |
| NextPageText |
Ruft den Text ab, der für die nächste Seitenschaltfläche angezeigt wird, oder legt den Text fest. |
| PageButtonCount |
Ruft die Anzahl der numerischen Schaltflächen ab, die gleichzeitig im Pagerelement des DataGrid Steuerelements angezeigt werden sollen, oder legt diese fest. |
| Position |
Dient zum Abrufen oder Festlegen der Position des Pager-Elements im DataGrid Steuerelement. |
| PrevPageText |
Dient zum Abrufen oder Festlegen des Texts, der für die vorherige Seitenschaltfläche angezeigt wird. |
| RegisteredCssClass |
Ruft die Css-Klasse (Cascading Stylesheet) ab, die beim Steuerelement registriert ist. (Geerbt von Style) |
| Site |
Dient zum ISite Abrufen oder Festlegen des Werts des Component. (Geerbt von Component) |
| VerticalAlign |
Dient zum Abrufen oder Festlegen der vertikalen Ausrichtung des Inhalts in einer Zelle. (Geerbt von TableItemStyle) |
| ViewState |
Ruft den Zustandsbehälter ab, der die Formatvorlagenelemente enthält. (Geerbt von Style) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Pager im DataGrid Steuerelement angezeigt wird. |
| Width |
Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von Style) |
| Wrap |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Inhalt einer Zelle in der Zelle umbrochen wird. (Geerbt von TableItemStyle) |
Methoden
| Name | Beschreibung |
|---|---|
| AddAttributesToRender(HtmlTextWriter, WebControl) |
Fügt Informationen zu horizontaler Ausrichtung, vertikaler Ausrichtung und Umbruch zur Liste der zu rendernden Attribute hinzu. (Geerbt von TableItemStyle) |
| AddAttributesToRender(HtmlTextWriter) |
Fügt HTML-Attribute und -Formatvorlagen hinzu, die dem angegebenen Element HtmlTextWritergerendert werden müssen. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von Style) |
| CopyFrom(Style) |
Kopiert die Formatvorlage des angegebenen Style Objekts in diese Instanz der DataGridPagerStyle Klasse. |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FillStyleAttributes(CssStyleCollection, IUrlResolutionService) |
Fügt die Formateigenschaften des angegebenen Objekts zu einem CssStyleCollection Objekt hinzu. (Geerbt von Style) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetService(Type) |
Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component) |
| GetStyleAttributes(IUrlResolutionService) |
Ruft das CssStyleCollection Objekt für das angegebene IUrlResolutionServiceimplementierte Objekt ab. (Geerbt von Style) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| LoadViewState(Object) |
Lädt den zuvor gespeicherten Zustand. (Geerbt von Style) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| MergeWith(Style) |
Führt die Formatvorlage des angegebenen Style Objekts mit dieser Instanz der DataGridPagerStyle Klasse zusammen. |
| Reset() |
Stellt das DataGridPagerStyle Objekt in seinen Standardwerten wieder her. |
| SaveViewState() |
Eine geschützte Methode. Speichert alle Status, die geändert wurden, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von Style) |
| SetBit(Int32) |
Eine geschützte interne Methode. Legt ein internes Bitmaskenfeld fest, das die Formateigenschaften angibt, die im Zustandsbehälter gespeichert sind. (Geerbt von Style) |
| SetDirty() |
Kennzeichnet den Style Zustand so, dass sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Style) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Style) |
| TrackViewState() |
Eine geschützte Methode. Markiert den Anfang für die Nachverfolgung von Zustandsänderungen für das Steuerelement. Alle Änderungen, die nach dem Nachverfolgen vorgenommen wurden, werden im Rahmen des Ansichtszustands des Steuerelements nachverfolgt und gespeichert. (Geerbt von Style) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IStateManager.IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement seine Ansichtszustandsänderungen nachverfolgt. (Geerbt von Style) |
| IStateManager.LoadViewState(Object) |
Lädt den zuvor gespeicherten Zustand. (Geerbt von Style) |
| IStateManager.SaveViewState() |
Gibt das Objekt zurück, das Zustandsänderungen enthält. (Geerbt von Style) |
| IStateManager.TrackViewState() |
Beginnt mit der Nachverfolgung von Zustandsänderungen. (Geerbt von Style) |