Freigeben über


DataPager Klasse

Definition

Stellt Pagingfunktionen für datengebundene Steuerelemente bereit, die die IPageableItemContainer Schnittstelle implementieren, z. B. das ListView Steuerelement.

public ref class DataPager : System::Web::UI::Control, System::Web::UI::IAttributeAccessor, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.DataPager), "DataPager.ico")]
[System.Web.UI.Themeable(true)]
public class DataPager : System.Web.UI.Control, System.Web.UI.IAttributeAccessor, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor
[System.Web.UI.Themeable(true)]
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.DataPager), "DataPager.bmp")]
public class DataPager : System.Web.UI.Control, System.Web.UI.IAttributeAccessor, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.DataPager), "DataPager.ico")>]
[<System.Web.UI.Themeable(true)>]
type DataPager = class
    inherit Control
    interface IAttributeAccessor
    interface INamingContainer
    interface ICompositeControlDesignerAccessor
[<System.Web.UI.Themeable(true)>]
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.DataPager), "DataPager.bmp")>]
type DataPager = class
    inherit Control
    interface IAttributeAccessor
    interface INamingContainer
    interface ICompositeControlDesignerAccessor
Public Class DataPager
Inherits Control
Implements IAttributeAccessor, ICompositeControlDesignerAccessor, INamingContainer
Vererbung
DataPager
Attribute
Implementiert

Beispiele

Das folgende Beispiel zeigt, wie einem Steuerelement Pagingfunktionen ListView hinzugefügt werden. Dieses Beispiel enthält zwei DataPager Steuerelemente, die verwendet werden, um Daten desselben ListView Steuerelements zu durchlaufen.

<%@ 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 id="Head1" runat="server">
    <title>DataPager Example</title>
    <style type="text/css">        
      th
      {
        background-color:#eef4fa;
        border-top:solid 1px #9dbbcc;
        border-bottom:solid 1px #9dbbcc;
      }
      .itemSeparator { border-right: 1px solid #ccc }
      .groupSeparator
      {
        height: 1px;
        background-color: #cccccc;
      }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataPager Example</h3>
      
      <!-- The first DataPager control. -->
      <asp:DataPager runat="server" ID="BeforeListDataPager"
        PagedControlID="ProductsListView" 
        PageSize="18">
        <Fields>
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            FirstPageImageUrl="~/images/first.gif" />
          <asp:NumericPagerField ButtonCount="10" />
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            LastPageImageUrl="~/images/last.gif" />
        </Fields>
      </asp:DataPager>

      <asp:ListView ID="ProductsListView" 
        DataSourceID="ProductsDataSource" 
        GroupItemCount="3"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" id="tbl1" runat="server">
            <tr>
              <th colspan="5">PRODUCTS LIST</th>
            </tr>
            <tr runat="server" id="groupPlaceholder"></tr>
          </table>
        </LayoutTemplate>
        <GroupTemplate>
          <tr runat="server" id="tr1">
            <td runat="server" id="itemPlaceholder"></td>
          </tr>
        </GroupTemplate>
        <GroupSeparatorTemplate>
          <tr runat="server">
            <td colspan="5">
                <div class="groupSeparator"><hr></div>
              </td>
          </tr>
        </GroupSeparatorTemplate>
        <ItemTemplate>
          <td align="center" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" 
              Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' /><br />
            <asp:Image ID="ProductImage" runat="server"
              ImageUrl='<%#"~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' /><br />
            <b>Price:</b> <%# Eval("ListPrice", "{0:c}")%> <br />
          </td>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <td class="itemSeparator" runat="server">&nbsp;</td>
        </ItemSeparatorTemplate>
      </asp:ListView>

      <!-- The second DataPager control. -->
      <asp:DataPager runat="server" ID="AfterListDataPager"
        PagedControlID="ProductsListView" 
        PageSize="18">
        <Fields>
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            FirstPageImageUrl="~/images/first.gif" />
          <asp:NumericPagerField ButtonCount="10" />
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            LastPageImageUrl="~/images/last.gif" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID">
      </asp:SqlDataSource>
      
    </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 id="Head1" runat="server">
    <title>DataPager Example</title>
    <style type="text/css">        
      th
      {
        background-color:#eef4fa;
        border-top:solid 1px #9dbbcc;
        border-bottom:solid 1px #9dbbcc;
      }
      .itemSeparator { border-right: 1px solid #ccc }
      .groupSeparator
      {
        height: 1px;
        background-color: #cccccc;
      }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DataPager Example</h3>
      
      <!-- The first DataPager control. -->
      <asp:DataPager runat="server" ID="BeforeListDataPager"
        PagedControlID="ProductsListView" 
        PageSize="18">
        <Fields>
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            FirstPageImageUrl="~/images/first.gif" />
          <asp:NumericPagerField ButtonCount="10" />
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            LastPageImageUrl="~/images/last.gif" />
        </Fields>
      </asp:DataPager>

      <asp:ListView ID="ProductsListView" 
        DataSourceID="ProductsDataSource" 
        GroupItemCount="3"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" id="tbl1" runat="server">
            <tr>
              <th colspan="5">PRODUCTS LIST</th>
            </tr>
            <tr runat="server" id="groupPlaceholder"></tr>
          </table>
        </LayoutTemplate>
        <GroupTemplate>
          <tr runat="server" id="tr1">
            <td runat="server" id="itemPlaceholder"></td>
          </tr>
        </GroupTemplate>
        <GroupSeparatorTemplate>
          <tr runat="server">
            <td colspan="5">
                <div class="groupSeparator"><hr></div>
              </td>
          </tr>
        </GroupSeparatorTemplate>
        <ItemTemplate>
          <td align="center" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" 
              Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" & Eval("ProductID") %>' /><br />
            <asp:Image ID="ProductImage" runat="server"
              ImageUrl='<%#"~/images/thumbnails/" & Eval("ThumbnailPhotoFileName") %>' /><br />
            <b>Price:</b> <%# Eval("ListPrice", "{0:c}")%> <br />
          </td>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <td class="itemSeparator" runat="server">&nbsp;</td>
        </ItemSeparatorTemplate>
      </asp:ListView>

      <!-- The second DataPager control. -->
      <asp:DataPager runat="server" ID="AfterListDataPager"
        PagedControlID="ProductsListView" 
        PageSize="18">
        <Fields>
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            FirstPageImageUrl="~/images/first.gif" />
          <asp:NumericPagerField ButtonCount="10" />
          <asp:NextPreviousPagerField ButtonType="Image"
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false"
            LastPageImageUrl="~/images/last.gif" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Hinweise

In diesem Thema:

Einführung

Die DataPager Klasse wird zum Seitendaten und zum Anzeigen von Navigationssteuerelementen für datengebundene Steuerelemente verwendet, die die IPageableItemContainer Schnittstelle implementieren. (Ein Beispiel für ein Steuerelement, das die Schnittstelle implementiert, ist das ListView Steuerelement.)

Sie können das DataPager Steuerelement dem datengebundenen Steuerelement mithilfe der PagedControlID Eigenschaft zuordnen. Alternativ können Sie das DataPager Steuerelement in der datengebundenen Steuerelementhierarchie platzieren. Beispielsweise können Sie das ListViewDataPager Steuerelement im Steuerelement in die ListView.LayoutTemplate Vorlage einfügen.

Sie können die Anzahl der Elemente anpassen, die für jede Datenseite angezeigt werden, indem Sie die PageSize Eigenschaft ändern. Sie können auch ändern, wie eine Seite an den Server übermittelt wird, indem Sie die QueryStringField Eigenschaft festlegen.

Pager-Felder

Damit das DataPager Steuerelement Navigationssteuerelemente anzeigen kann, müssen Sie dem Steuerelement Pagerfelder hinzufügen. Die Pagerfelder werden von der DataPagerField Klasse abgeleitet. In der folgenden Tabelle sind die Seitenfeldtypen aufgeführt, die Sie verwenden können.

Pager-Feldtyp Beschreibung
NextPreviousPagerField Ermöglicht Benutzern das Gleichzeitige Navigieren durch Seiten auf einer Seite oder zum Springen zur ersten oder letzten Seite.
NumericPagerField Ermöglicht Benutzern das Auswählen einer Seite nach Seitenzahl.
TemplatePagerField Ermöglicht ihnen das Erstellen einer benutzerdefinierten Paging-Benutzeroberfläche.

Zum deklarativen Hinzufügen von Pagerfeldern zum DataPager Steuerelement fügen Sie dem DataPager Steuerelement ein Fields Element hinzu. Anschließend können Sie dem Fields Element die Pagerfelder hinzufügen. Die Pagerfelder werden der Fields Auflistung in der Reihenfolge hinzugefügt, in der sie im Fields Element angezeigt werden. Mit der Fields Auflistung können Sie die Pagerfelder im DataPager Steuerelement programmgesteuert verwalten.

Seiteneigenschaften

In der folgenden Tabelle sind schreibgeschützte Eigenschaften des DataPager Steuerelements aufgeführt, die Merkmale der Datenseite angeben. Diese Eigenschaften werden in der TemplatePagerField Regel für Bindungsausdrücke im Objekt verwendet.

Eigentum Beschreibung
MaximumRows Die maximale Anzahl von Datensätzen, die für jede Datenseite angezeigt werden.
StartRowIndex Der Index des ersten Datensatzes, der auf einer Datenseite angezeigt wird.
TotalRowCount Die Gesamtzahl der Datensätze, die in der zugrunde liegenden Datenquelle verfügbar sind.

Zugänglichkeit

Das standardmäßige Markup, das für dieses Steuerelement standardmäßig gerendert wird, entspricht möglicherweise nicht den Richtlinien für die Barrierefreiheit von Webinhalten, z. B. den Richtlinien für die Barrierefreiheit von Webinhalten 1.0 (WCAG) priorität 1. Ausführliche Informationen zur Unterstützung der Barrierefreiheit für dieses Steuerelement finden Sie unter ASP.NET Steuerelemente und Barrierefreiheit.

Deklarative Syntax

<asp:DataPager
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PagedControlID="string"
    PageSize="integer"
    runat="server"
    SkinID="string"
    Visible="True|False"
>
        <Fields>
            <asp:NextPreviousPagerField
                ButtonCssClass="string"
                ButtonType="Button|Image|Link"
                FirstPageImageUrl="string"
                FirstPageText="string"
                LastPageImageUrl="string"
                LastPageText="string"
                NextPageImageUrl="string"
                NextPageText="string"
                PreviousPageImageUrl="string"
                PreviousPageText="string"
                RenderDisabledButtonsAsLabels="True|False"
                RenderNonBreakingSpacesBetweenControls="True|False"
                ShowFirstPageButton="True|False"
                ShowLastPageButton="True|False"
                ShowNextPageButton="True|False"
                ShowPreviousPageButton="True|False"
                Visible="True|False"
            />
            <asp:NumericPagerField
                ButtonCount="integer"
                ButtonType="Button|Image|Link"
                CurrentPageLabelCssClass="string"
                NextPageImageUrl="string"
                NextPageText="string"
                NextPreviousButtonCssClass="string"
                NumericButtonCssClass="string"                 PreviousPageImageUrl="string"
                PreviousPageText="string"
                RenderNonBreakingSpacesBetweenControls="True|False"
                Visible="True|False"
            />
            <asp:TemplatePagerField
                OnPagerCommand="PagerCommand event handler"
                Visible="True|False"
            />
        </Fields>
</asp:DataPager>

Konstruktoren

Name Beschreibung
DataPager()

Initialisiert eine neue Instanz der DataPager-Klasse.

Eigenschaften

Name Beschreibung
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AppRelativeTemplateSourceDirectory

Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält.

(Geerbt von Control)
Attributes

Ruft eine Auflistung von benutzerdefinierten Attributnamen-Wert-Paaren für das DataPager Steuerelement ab.

BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

(Geerbt von Control)
ClientIDMode

Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird.

(Geerbt von Control)
Context

Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist.

(Geerbt von Control)
Controls

Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für das DataPager Steuerelement in der Ui-Hierarchie darstellt.

DataItemContainer

Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird.

(Geerbt von Control)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
EnableTheming

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten.

(Geerbt von Control)
EnableViewState

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
Fields

Ruft eine Auflistung von DataPagerField Objekten ab, die die Pagerfelder darstellen, die in einem DataPager Steuerelement angegeben sind.

HasChildViewState

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen.

(Geerbt von Control)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt.

(Geerbt von Control)
MaximumRows

Ruft die maximale Anzahl von Datensätzen ab, die für jede Datenseite angezeigt werden.

NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
PagedControlID

Dient zum Abrufen oder Festlegen ID des Steuerelements, das die Daten enthält, die DataPager vom Steuerelement ausgelagert werden.

PageSize

Ruft die Anzahl der Datensätze ab, die für jede Datenseite angezeigt werden, oder legt diese fest.

Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab.

(Geerbt von Control)
QueryStringField

Dient zum Abrufen oder Festlegen des Namens des Abfragezeichenfolgenfelds.

RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist.

(Geerbt von Control)
Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest.

(Geerbt von Control)
StartRowIndex

Ruft den Index des ersten Datensatzes ab, der auf einer Datenseite angezeigt wird.

TagKey

Ruft das HTML-Element ab, das zum Rendern des DataPager Steuerelements verwendet wird.

TemplateControl

Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab.

(Geerbt von Control)
TotalRowCount

Ruft die Gesamtanzahl der Datensätze ab, die vom zugrunde liegenden Datenquellenobjekt abgerufen werden, auf das vom zugeordneten datengebundenen Steuerelement verwiesen wird.

UniqueID

Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
ValidateRequestMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest.

(Geerbt von Control)
Visible

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird.

(Geerbt von Control)

Methoden

Name Beschreibung
AddAttributesToRender(HtmlTextWriter)

Fügt dem angegebenen HtmlTextWriter Objekt HTML-Attribute und -Formatvorlagen hinzu, die im Browser gerendert werden sollen.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu.

(Geerbt von Control)
ApplyStyleSheetSkin(Page)

Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID Wert auf null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit.

(Geerbt von Control)
ConnectToEvents(IPageableItemContainer)

Verbindet Ereignisse mit Ereignishandlermethoden im DataPager Steuerelement.

CreateChildControls()

Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält.

(Geerbt von Control)
CreatePagerFields()

Erstellt die DataPagerField Objekte, die in der Fields Eigenschaft des DataPager Steuerelements enthalten sind.

DataBind()

Bindet das DataPager Steuerelement und alle untergeordneten Steuerelemente an eine Datenquelle.

DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung von Renderingdaten.

(Geerbt von Control)
EnsureChildControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen id und einer ganzzahligen Zahl, die pathOffset im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen.

(Geerbt von Control)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen id Parameter.

(Geerbt von Control)
FindPageableItemContainer()

Ruft das datengebundene Steuerelement ab, das dem DataPager Steuerelement zugeordnet ist.

Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetDesignModeState()

Ruft Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind.

(Geerbt von Control)
IsLiteralContent()

Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält.

(Geerbt von Control)
LoadControlState(Object)

Lädt die Statusinformationen für die Eigenschaften im DataPager Steuerelement, die zwischen Postbacks beibehalten werden müssen, auch wenn die EnableViewState Eigenschaft auf false".

LoadViewState(Object)

Stellt Ansichtsstatusinformationen für das DataPager Steuerelement wieder her, das von der SaveViewState() Methode während einer vorherigen Seitenanforderung gespeichert wurde.

MapPathSecure(String)

Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob ein Ereignis für das DataPager Steuerelement an die Benutzeroberflächen-Hierarchie der Seite übergeben wird.

OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnInit(EventArgs)

Löst das Init-Ereignis aus.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.

OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

(Geerbt von Control)
OnTotalRowCountAvailable(Object, PageEventArgs)

Behandelt das TotalRowCountAvailable Ereignis.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream Verwendeten zum Lesen einer Datei ab.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu.

(Geerbt von Control)
RecreateChildControls()

Erstellt untergeordnete Steuerelemente des DataPager Steuerelements zur Entwurfszeit.

RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Sendet den DataPager Steuerelementinhalt an das angegebene HtmlTextWriter Objekt, das den inhalt schreibt, der in den Browser gerendert werden soll.

RenderBeginTag(HtmlTextWriter)

Rendert das HTML-Öffnungstag des DataPager Steuerelements an den angegebenen Writer.

RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt des DataPager Steuerelements an den angegebenen Writer.

RenderControl(HtmlTextWriter, ControlAdapter)

Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann.

(Geerbt von Control)
SaveControlState()

Speichert den Status der Eigenschaften im DataPager Steuerelement, die zwischen Postbacks beibehalten werden müssen, auch wenn die EnableViewState Eigenschaft auf false".

SaveViewState()

Speichert alle Änderungen am Ansichtszustand eines DataPager Steuerelements, die seit der Zurückversendung der Seite auf dem Server aufgetreten sind.

SetDesignModeState(IDictionary)

Legt Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetPageProperties(Int32, Int32, Boolean)

Legt die seitenbezogenen Eigenschaften im DataPager Steuerelement fest.

SetRenderMethodDelegate(RenderMethod)

Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Verfolgt Ansichtszustandsänderungen am DataPager Steuerelement, sodass sie im Objekt des Steuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden.

Ereignisse

Name Beschreibung
DataBinding

Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt.

(Geerbt von Control)
Disposed

Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird.

(Geerbt von Control)
Init

Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist.

(Geerbt von Control)
Load

Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird.

(Geerbt von Control)
PreRender

Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern.

(Geerbt von Control)
Unload

Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IAttributeAccessor.GetAttribute(String)

Ruft den Attributwert mit dem angegebenen Namen aus dem DataPager Steuerelement ab.

IAttributeAccessor.SetAttribute(String, String)

Legt ein Attribut des DataPager Steuerelements mit dem angegebenen Namen und Wert fest.

ICompositeControlDesignerAccessor.RecreateChildControls()

Erstellt die untergeordneten Steuerelemente des DataPager Steuerelements zur Entwurfszeit.

IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Mitglieds finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Mitglieds finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)

Erweiterungsmethoden

Name Beschreibung
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement.

EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement.

EnableDynamicData(INamingContainer, Type)

Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement.

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.

GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.

TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.

Gilt für:

Weitere Informationen