Freigeben über


GridView Klasse

Definition

Zeigt die Werte einer Datenquelle in einer Tabelle an, in der jede Spalte ein Feld darstellt und jede Zeile einen Datensatz darstellt. Mit dem GridView Steuerelement können Sie diese Elemente auswählen, sortieren und bearbeiten.

public ref class GridView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IPersistedSelector, System::Web::UI::WebControls::IPostBackContainer
public ref class GridView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataKeysControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPersistedSelector, System::Web::UI::WebControls::IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class GridView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IPersistedSelector, System.Web.UI.WebControls.IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class GridView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataKeysControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPersistedSelector, System.Web.UI.WebControls.IPostBackContainer
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type GridView = class
    inherit CompositeDataBoundControl
    interface IPostBackContainer
    interface IPostBackEventHandler
    interface ICallbackContainer
    interface ICallbackEventHandler
    interface IPersistedSelector
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type GridView = class
    inherit CompositeDataBoundControl
    interface IPostBackContainer
    interface IPostBackEventHandler
    interface ICallbackContainer
    interface ICallbackEventHandler
    interface IPersistedSelector
    interface IDataKeysControl
    interface IDataBoundListControl
    interface IDataBoundControl
    interface IFieldControl
Public Class GridView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IPostBackContainer, IPostBackEventHandler
Public Class GridView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundListControl, IDataKeysControl, IFieldControl, IPersistedSelector, IPostBackContainer, IPostBackEventHandler
Vererbung
Attribute
Implementiert

Beispiele

Ein Visual Studio-Websiteprojekt mit Quellcode ist verfügbar, um dieses Thema zu begleiten: Herunterladen.

Im folgenden Beispiel wird veranschaulicht, wie das GridView Steuerelement verwendet wird, um die Werte aus der Tabelle "Customers" der AdventureWorksLT-Beispieldatenbank in Microsoft SQL Server anzuzeigen. Die Werte werden mithilfe eines SqlDataSource Steuerelements abgerufen.

<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>
<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

Im folgenden Beispiel wird die Verwendung des GridView Steuerelements und eines LinqDataSource Steuerelements veranschaulicht, damit Sie Datensätze bearbeiten können.

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>
<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

Ein Beispiel für den Zugriff auf Werte in Zellen finden Sie unter GridViewRow.

Hinweise

In diesem Thema:

Einführung

Das GridView Steuerelement wird verwendet, um die Werte einer Datenquelle in einer Tabelle anzuzeigen. Jede Spalte stellt ein Feld dar, während jede Zeile einen Datensatz darstellt. Das GridView Steuerelement unterstützt die folgenden Features:

  • Binden an Datenquellensteuerelemente, z SqlDataSource. B. .

  • Integrierte Sortierfunktionen.

  • Integrierte Update- und Löschfunktionen.

  • Integrierte Pagingfunktionen.

  • Integrierte Zeilenauswahlfunktionen.

  • Programmgesteuerter Zugriff auf das GridView Objektmodell zum dynamischen Festlegen von Eigenschaften, Behandeln von Ereignissen usw.

  • Mehrere Schlüsselfelder.

  • Mehrere Datenfelder für die Hyperlinkspalten.

  • Anpassbare Darstellung durch Designs und Stile.

  • Informationen zu den anderen datengebundenen Steuerelementen, die in ASP.NET verfügbar sind, finden Sie unter Data-Bound Webserversteuerelemente.

Hinweis

Wenn Sie mit dem DataGrid Steuerelement aus .NET Framework, Version 1.0, vertraut sind, ist das GridView Steuerelement der Nachfolger des DataGrid Steuerelements.

Spaltenfelder

Jede Spalte im GridView Steuerelement wird durch ein DataControlField Objekt dargestellt. Standardmäßig ist die AutoGenerateColumns Eigenschaft auf truefestgelegt, wodurch ein AutoGeneratedField Objekt für jedes Feld in der Datenquelle erstellt wird. Jedes Feld wird dann als Spalte im GridView Steuerelement in der Reihenfolge gerendert, in der jedes Feld in der Datenquelle angezeigt wird.

Sie können auch manuell steuern, welche Spaltenfelder im GridView Steuerelement angezeigt werden, indem Sie die AutoGenerateColumns Eigenschaft auf false eine eigene Spaltenfeldauflistung festlegen und dann definieren. Verschiedene Spaltenfeldtypen bestimmen das Verhalten der Spalten im Steuerelement. In der folgenden Tabelle sind die verschiedenen Spaltenfeldtypen aufgeführt, die verwendet werden können.

Spaltenfeldtyp Beschreibung
BoundField Zeigt den Wert eines Felds in einer Datenquelle an. Dies ist der Standardspaltentyp des GridView Steuerelements.
ButtonField Zeigt eine Befehlsschaltfläche für jedes Element im GridView Steuerelement an. Auf diese Weise können Sie eine Spalte mit benutzerdefinierten Schaltflächensteuerelementen erstellen, z. B. die Schaltfläche "Hinzufügen" oder "Entfernen".
CheckBoxField Zeigt ein Kontrollkästchen für jedes Element im GridView Steuerelement an. Dieser Spaltenfeldtyp wird häufig verwendet, um Felder mit einem booleschen Wert anzuzeigen.
CommandField Zeigt vordefinierte Befehlsschaltflächen zum Ausführen von Auswahl-, Bearbeitungs- oder Löschvorgängen an.
HyperLinkField Zeigt den Wert eines Felds in einer Datenquelle als Hyperlink an. Mit diesem Spaltenfeldtyp können Sie ein zweites Feld an die URL des Links binden.
ImageField Zeigt ein Bild für jedes Element im GridView Steuerelement an.
TemplateField Zeigt benutzerdefinierten Inhalt für jedes Element im GridView Steuerelement gemäß einer angegebenen Vorlage an. Mit diesem Spaltenfeldtyp können Sie ein benutzerdefiniertes Spaltenfeld erstellen.

Um eine Spaltenfeldauflistung deklarativ zu definieren, fügen Sie zuerst öffnende und schließende <Columns> Tags zwischen den öffnenden und schließenden Tags des GridView Steuerelements hinzu. Listen Sie als Nächstes die Spaltenfelder auf, die zwischen den öffnenden und schließenden <Columns> Tags eingeschlossen werden sollen. Die angegebenen Spalten werden der Auflistung in der Columns aufgeführten Reihenfolge hinzugefügt. Die Columns Auflistung speichert alle Spaltenfelder im Steuerelement und ermöglicht es Ihnen, die Spaltenfelder im GridView Steuerelement programmgesteuert zu verwalten.

Explizit deklarierte Spaltenfelder können in Kombination mit automatisch generierten Spaltenfeldern angezeigt werden. Wenn beide verwendet werden, werden explizit deklarierte Spaltenfelder zuerst gerendert, gefolgt von den automatisch generierten Spaltenfeldern.

Hinweis

Automatisch generierte Spaltenfelder werden der Columns Auflistung nicht hinzugefügt.

Binden an Daten

Das GridView Steuerelement kann an ein Datenquellensteuerelement (z. B. das SqlDataSource Steuerelement oder ObjectDataSource Steuerelement) oder an eine beliebige Datenquellensammlung gebunden werden, die die System.Collections.IEnumerable Schnittstelle implementiert, z System.Data.DataView. B. , , System.Collections.ArrayListoder System.Collections.Generic.List<T>andere Sammlungstypen. Verwenden Sie eine der folgenden Methoden, um das GridView Steuerelement an den entsprechenden Datenquellentyp zu binden:

  • Um eine Bindung an ein Datenquellensteuerelement zu erstellen, legen Sie die DataSourceID Eigenschaft des GridView Steuerelements auf den ID Wert des Datenquellensteuerelements fest. Das GridView Steuerelement wird automatisch an das angegebene Datenquellensteuerelement gebunden und kann die Funktionen des Datenquellensteuerelements nutzen, um Sortierung, Aktualisierung, Löschung und Paging durchzuführen. Dies ist die bevorzugte Methode zum Binden an Daten.

  • Um eine Bindung an eine Datenquelle zu erstellen, die die System.Collections.IEnumerable Schnittstelle implementiert, legen Sie die DataSource Eigenschaft des GridView Steuerelements programmgesteuert auf die Datenquelle fest, und rufen Sie dann die DataBind Methode auf. Bei Verwendung dieser Methode stellt das GridView Steuerelement keine integrierte Sortier-, Aktualisierungs-, Lösch- und Pagingfunktion bereit. Sie müssen diese Funktionalität mithilfe des entsprechenden Ereignisses bereitstellen.

Weitere Informationen zur Datenbindung finden Sie unter ASP.NET Datenzugriffsinhaltszuordnung.

Hinweis

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die bösartige Clientskripts enthalten können. Überprüfen Sie alle Informationen, die von einem Client auf ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie sie in Ihrer Anwendung anzeigen. Wenn möglich, wird dringend empfohlen, dass Werte HTML-codiert sind, bevor sie in diesem Steuerelement angezeigt werden (standardmäßig werden die Werte der BoundField Klasse HTML-codiert). ASP.NET stellt eine Eingabeanforderungsüberprüfungsfunktion bereit, um Skripts und HTML in der Benutzereingabe zu blockieren. Überprüfungsserversteuerelemente werden auch zur Bewertung der Benutzereingabe bereitgestellt. Weitere Informationen finden Sie in der Einführung in die Überprüfungssteuerelemente.

Datenvorgänge

Das GridView Steuerelement bietet viele integrierte Funktionen, mit denen der Benutzer Elemente im Steuerelement sortieren, aktualisieren, löschen, auswählen und durchblättern kann. Wenn das GridView Steuerelement an ein Datenquellensteuerelement gebunden ist, kann das GridView Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Sortier-, Aktualisierungs- und Löschfunktionen bereitstellen.

Hinweis

Das GridView Steuerelement kann Unterstützung für das Sortieren, Aktualisieren und Löschen mit anderen Arten von Datenquellen bieten. Sie müssen jedoch einen geeigneten Ereignishandler mit der Implementierung für diese Vorgänge bereitstellen.

Durch sortieren kann der Benutzer die Elemente im GridView Steuerelement in Bezug auf eine bestimmte Spalte sortieren, indem er auf die Kopfzeile der Spalte klickt. Um die Sortierung zu aktivieren, legen Sie die AllowSorting Eigenschaft auf true.

Die automatischen Aktualisierungs-, Lösch- und Auswahlfunktionen werden aktiviert, wenn auf eine Schaltfläche in einem ButtonField Oder TemplateField Spaltenfeld mit dem Befehlsnamen "Bearbeiten", "Löschen" bzw. "Auswählen" geklickt wird. Das GridView Steuerelement kann automatisch ein CommandField Spaltenfeld mit einer Schaltfläche "Bearbeiten", "Löschen" oder "Auswählen" hinzufügen, wenn bzwAutoGenerateEditButtonAutoGenerateDeleteButton. die Eigenschaft auf "Bearbeiten", "Löschen" oder AutoGenerateSelectButton "trueAuswählen" festgelegt ist.

Hinweis

Das Einfügen von Datensätzen in die Datenquelle wird vom GridView Steuerelement nicht direkt unterstützt. Es ist jedoch möglich, Datensätze mithilfe des Steuerelements in Verbindung mit dem GridViewDetailsView Steuerelement oder FormView Steuerelement einzufügen. Weitere Informationen finden Sie unter DetailsView bzw FormView. .

Anstatt alle Datensätze in der Datenquelle gleichzeitig anzuzeigen, kann das GridView Steuerelement die Datensätze automatisch auf Seiten aufteilen. Zum Aktivieren der Seitenverwaltung legen Sie die AllowPaging Eigenschaft auf true.

Hinweis

Das GridView Steuerelement wird basierend auf den in dem Postback gespeicherten ViewStateInformationen erneut erstellt. Wenn das GridView Steuerelement ein oder ein TemplateFieldCommandField Steuerelement enthält, auf das die CausesValidation Eigenschaft festgelegt trueist, muss die EnableViewState Eigenschaft auch festgelegt werden, um true sicherzustellen, dass gleichzeitige Datenvorgänge, z. B. Aktualisierungen und Löschvorgänge, auf die entsprechende Zeile angewendet werden.

Anpassen der Benutzeroberfläche

Sie können die Darstellung des GridView Steuerelements anpassen, indem Sie die Formatvorlageneigenschaften für die verschiedenen Teile des Steuerelements festlegen. In der folgenden Tabelle sind die verschiedenen Formateigenschaften aufgeführt.

Style-Eigenschaft Beschreibung
AlternatingRowStyle Die Formatvorlageneinstellungen für die abwechselnden Datenzeilen im GridView Steuerelement. Wenn diese Eigenschaft festgelegt ist, werden die Datenzeilen zwischen den RowStyle Einstellungen und den AlternatingRowStyle Einstellungen abwechselnd angezeigt.
EditRowStyle Die Formatvorlageneinstellungen für die Zeile, die GridView im Steuerelement bearbeitet wird.
EmptyDataRowStyle Die Formatvorlageneinstellungen für die leere Datenzeile, die GridView im Steuerelement angezeigt wird, wenn die Datenquelle keine Datensätze enthält.
FooterStyle Die Formatvorlageneinstellungen für die Fußzeile des GridView Steuerelements.
HeaderStyle Die Formatvorlageneinstellungen für die Kopfzeile des GridView Steuerelements.
PagerStyle Die Formatvorlageneinstellungen für die Pagerzeile des GridView Steuerelements.
RowStyle Die Formatvorlageneinstellungen für die Datenzeilen im GridView Steuerelement. Wenn die AlternatingRowStyle Eigenschaft ebenfalls festgelegt wird, werden die Datenzeilen zwischen den RowStyle Einstellungen und den AlternatingRowStyle Einstellungen abwechselnd angezeigt.
SelectedRowStyle Die Formatvorlageneinstellungen für die ausgewählte Zeile im GridView Steuerelement.
SortedAscendingCellStyle Die Formatvorlageneinstellung für die Datenspalte, nach der GridView die Daten im Steuerelement sortiert werden. Wenn diese Formatvorlage festgelegt ist, wird die Formatvorlage (z. B. hervorgehobene Spalte) auf Zellen angewendet, wenn die Daten in aufsteigender Reihenfolge sortiert werden.
SortedAscendingHeaderStyle Die Formatvorlageneinstellung für die Datenspalte, nach der GridView die Daten im Steuerelement sortiert werden. Wenn diese Formatvorlage festgelegt ist, wird ein Pfeil, der angibt, dass die Daten aufsteigend sortiert sind, in der Kopfzeile des GridView Steuerelements platziert, wenn die Daten in aufsteigender Reihenfolge sortiert werden.
SortedDescendingCellStyle Die Formatvorlageneinstellung für die Datenspalte, nach der GridView die Daten im Steuerelement sortiert werden. Wenn diese Formatvorlage festgelegt ist, wird die Formatvorlage (z. B. hervorgehobene Spalte) auf Zellen angewendet, wenn die Daten in absteigender Reihenfolge sortiert werden.
SortedDescendingHeaderStyle Die Formatvorlageneinstellung für die Datenspalte, nach der GridView die Daten im Steuerelement sortiert werden. Wenn diese Formatvorlage festgelegt ist, wird ein nach unten zeigender Pfeil auf der Kopfzeile der GridView Daten platziert, wenn die Daten in absteigender Reihenfolge sortiert werden.

Sie können auch verschiedene Teile des Steuerelements ein- oder ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die steuern, welche Teile angezeigt oder ausgeblendet werden.

Eigentum Beschreibung
ShowFooter Blendet den Fußzeilenbereich des GridView Steuerelements ein oder aus.
ShowHeader Blendet den Kopfzeilenabschnitt des GridView Steuerelements ein oder aus.

Ereignisse

Das GridView Steuerelement stellt mehrere Ereignisse bereit, mit denen Sie programmieren können. Auf diese Weise können Sie eine benutzerdefinierte Routine ausführen, wenn ein Ereignis auftritt. In der folgenden Tabelle sind die Ereignisse aufgeführt, die vom GridView Steuerelement unterstützt werden.

Ereignis Beschreibung
PageIndexChanged Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber nachdem das GridView Steuerelement den Auslagerungsvorgang verarbeitet hat. Dieses Ereignis wird häufig verwendet, wenn Sie eine Aufgabe ausführen müssen, nachdem der Benutzer zu einer anderen Seite im Steuerelement navigiert hat.
PageIndexChanging Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber bevor das GridView Steuerelement den Auslagerungsvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Auslagerungsvorgang abzubrechen.
RowCancelingEdit Tritt auf, wenn auf die Schaltfläche "Abbrechen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Bearbeitungsmodus verlässt. Dieses Ereignis wird häufig verwendet, um den Abbruchvorgang zu beenden.
RowCommand Tritt auf, wenn auf eine Schaltfläche im GridView Steuerelement geklickt wird. Dieses Ereignis wird häufig verwendet, um eine Aufgabe auszuführen, wenn auf eine Schaltfläche im Steuerelement geklickt wird.
RowCreated Tritt auf, wenn eine neue Zeile im GridView Steuerelement erstellt wird. Dieses Ereignis wird häufig verwendet, um den Inhalt einer Zeile zu ändern, wenn die Zeile erstellt wird.
RowDataBound Tritt auf, wenn eine Datenzeile an Daten im GridView Steuerelement gebunden ist. Dieses Ereignis wird häufig verwendet, um den Inhalt einer Zeile zu ändern, wenn die Zeile an Daten gebunden ist.
RowDeleted Tritt auf, wenn auf die Schaltfläche "Löschen" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Löschvorgangs zu überprüfen.
RowDeleting Tritt auf, wenn auf die Schaltfläche "Löschen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um den Löschvorgang abzubrechen.
RowEditing Tritt auf, wenn auf die Schaltfläche "Bearbeiten" einer Zeile geklickt wird, aber bevor das GridView Steuerelement in den Bearbeitungsmodus wechselt. Dieses Ereignis wird häufig verwendet, um den Bearbeitungsvorgang abzubrechen.
RowUpdated Tritt auf, wenn auf die Schaltfläche "Aktualisieren" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement die Zeile aktualisiert hat. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Aktualisierungsvorgangs zu überprüfen.
RowUpdating Tritt auf, wenn auf die Schaltfläche "Aktualisieren" einer Zeile geklickt wird, aber bevor das GridView Steuerelement die Zeile aktualisiert. Dieses Ereignis wird häufig verwendet, um den Aktualisierungsvorgang abzubrechen.
SelectedIndexChanged Tritt auf, wenn auf die Schaltfläche "Auswählen" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement den Auswahlvorgang behandelt hat. Dieses Ereignis wird häufig verwendet, um eine Aufgabe auszuführen, nachdem eine Zeile im Steuerelement ausgewählt wurde.
SelectedIndexChanging Tritt auf, wenn auf die Schaltfläche "Auswählen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Auswahlvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Auswahlvorgang abzubrechen.
Sorted Tritt auf, wenn auf den Link zum Sortieren einer Spalte geklickt wird, aber nachdem das GridView Steuerelement den Sortiervorgang behandelt hat. Dieses Ereignis wird häufig verwendet, um eine Aufgabe auszuführen, nachdem der Benutzer auf einen Link klickt, um eine Spalte zu sortieren.
Sorting Tritt auf, wenn auf den Link zum Sortieren einer Spalte geklickt wird, aber bevor das GridView Steuerelement den Sortiervorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Sortiervorgang abzubrechen oder eine benutzerdefinierte Sortierroutine auszuführen.

Zugänglichkeit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das den Barrierefreiheitsstandards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET undASP.NET Steuerelemente und Barrierefreiheit.

Deklarative Syntax

<asp:GridView
    AccessKey="string"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateSelectButton="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    EmptyDataText="string"
    Enabled="True|False"
    EnableSortingAndPagingCallbacks="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnRowCancelingEdit="RowCancelingEdit event handler"
    OnRowCommand="RowCommand event handler"
    OnRowCreated="RowCreated event handler"
    OnRowDataBound="RowDataBound event handler"
    OnRowDeleted="RowDeleted event handler"
    OnRowDeleting="RowDeleting event handler"
    OnRowEditing="RowEditing event handler"
    OnRowUpdated="RowUpdated event handler"
    OnRowUpdating="RowUpdating event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
        NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    PageSize="integer"
    RowHeaderColumn="string"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingRowStyle />
        <Columns>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Columns>
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FooterStyle />
        <HeaderStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle />
        <SelectedRowStyle />
</asp:GridView>

Konstruktoren

Name Beschreibung
GridView()

Initialisiert eine neue Instanz der GridView-Klasse.

Eigenschaften

Name Beschreibung
AccessKey

Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AllowCustomPaging

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob benutzerdefinierte Paging aktiviert ist.

AllowPaging

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Paging-Feature aktiviert ist.

AllowSorting

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Sortierfeature aktiviert ist.

AlternatingRowStyle

Ruft einen Verweis auf das Objekt ab, mit dem TableItemStyle Sie die Darstellung alternierender Datenzeilen in einem GridView Steuerelement festlegen können.

AppRelativeTemplateSourceDirectory

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

(Geerbt von Control)
Attributes

Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen.

(Geerbt von WebControl)
AutoGenerateColumns

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob gebundene Felder für jedes Feld in der Datenquelle automatisch erstellt werden.

AutoGenerateDeleteButton

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine CommandField Feldspalte mit einer Schaltfläche "Löschen" für jede Datenzeile automatisch einem GridView Steuerelement hinzugefügt wird.

AutoGenerateEditButton

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine CommandField Feldspalte mit einer Schaltfläche "Bearbeiten" für jede Datenzeile automatisch einem GridView Steuerelement hinzugefügt wird.

AutoGenerateSelectButton

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine CommandField Feldspalte mit einer Schaltfläche "Auswählen" für jede Datenzeile automatisch einem GridView Steuerelement hinzugefügt wird.

BackColor

Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements.

(Geerbt von WebControl)
BackImageUrl

Ruft die URL auf ein Bild ab, das im Hintergrund eines GridView Steuerelements angezeigt werden soll, oder legt diese fest.

BindingContainer

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

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderStyle

Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BottomPagerRow

Ruft ein GridViewRow Objekt ab, das die untere Pagerzeile in einem GridView Steuerelement darstellt.

Caption

Ruft den Text ab, der in einem HTML-Beschriftungselement in einem GridView Steuerelement gerendert werden soll, oder legt diesen fest. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.

CaptionAlign

Dient zum Abrufen oder Festlegen der horizontalen oder vertikalen Position des HTML-Beschriftungselements in einem GridView Steuerelement. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.

CellPadding

Dient zum Abrufen oder Festlegen des Abstands zwischen dem Inhalt einer Zelle und dem Rahmen der Zelle.

CellSpacing

Dient zum Abrufen oder Festlegen des Abstands zwischen Zellen.

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)
ClientIDRowSuffix

Dient zum Abrufen oder Festlegen der Namen der Datenfelder, deren Werte an den ClientID Eigenschaftswert angefügt werden, um jede Instanz eines datengebundenen Steuerelements eindeutig zu identifizieren.

ClientIDRowSuffixDataKeys

Ruft die Datenwerte ab, die verwendet werden, um jede Instanz eines datengebundenen Steuerelements eindeutig zu identifizieren, wenn ASP.NET den ClientID Wert generiert.

ClientIDSeparator

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

(Geerbt von Control)
Columns

Ruft eine Auflistung von DataControlField Objekten ab, die die Spaltenfelder in einem GridView Steuerelement darstellen.

ColumnsGenerator

Dient zum Abrufen oder Festlegen des Steuerelements, das automatisch die Spalten für ein GridView Steuerelement generiert, das ASP.NET dynamische Datenfeatures verwendet.

Context

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

(Geerbt von Control)
Controls

Ruft eine Auflistung der untergeordneten Steuerelemente innerhalb des zusammengesetzten datengebundenen Steuerelements ab.

(Geerbt von CompositeDataBoundControl)
ControlStyle

Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CssClass

Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird.

(Geerbt von WebControl)
DataItemContainer

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

(Geerbt von Control)
DataKeyNames

Dient zum Abrufen oder Festlegen eines Arrays, das die Namen der Primärschlüsselfelder für die elemente enthält, die in einem GridView Steuerelement angezeigt werden.

DataKeys

Ruft eine Auflistung von DataKey Objekten ab, die den Datenschlüsselwert jeder Zeile in einem GridView Steuerelement darstellen.

DataKeysContainer

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

(Geerbt von Control)
DataMember

Dient zum Abrufen oder Festlegen des Namens der Liste der Daten, an die das datengebundene Steuerelement gebunden ist, in Fällen, an denen die Datenquelle mehrere unterschiedliche Liste von Datenelementen enthält.

(Geerbt von DataBoundControl)
DataSource

Dient zum Abrufen oder Festlegen des Objekts, aus dem das datengebundene Steuerelement die Liste der Datenelemente abruft.

(Geerbt von BaseDataBoundControl)
DataSourceID

Ruft die ID des Steuerelements ab, aus dem das datengebundene Steuerelement die Liste der Datenelemente abruft, oder legt diese fest.

(Geerbt von DataBoundControl)
DataSourceObject

Ruft ein Objekt ab, das die IDataSource Schnittstelle implementiert, die Zugriff auf den Dateninhalt des Objekts ermöglicht.

(Geerbt von DataBoundControl)
DeleteMethod

Dient zum Abrufen oder Festlegen des Namens der Methode, die aufgerufen werden soll, um Daten zu löschen.

DesignMode

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

(Geerbt von Control)
EditIndex

Ruft den Index der zu bearbeitenden Zeile ab oder legt diesen fest.

EditRowStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der Zeile festlegen können, die für die Bearbeitung in einem GridView Steuerelement ausgewählt ist.

EmptyDataRowStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der leeren Datenzeile festlegen können, die gerendert wird, wenn ein GridView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.

EmptyDataTemplate

Dient zum Abrufen oder Festlegen des benutzerdefinierten Inhalts für die leere Datenzeile, die gerendert wird, wenn ein GridView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.

EmptyDataText

Dient zum Abrufen oder Festlegen des Texts, der in der leeren Datenzeile gerendert wird, wenn ein GridView Steuerelement an eine Datenquelle gebunden ist, die keine Datensätze enthält.

Enabled

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Webserversteuerelement aktiviert ist.

(Geerbt von WebControl)
EnableModelValidation

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Validator-Steuerelement Ausnahmen verarbeitet, die bei Einfüge- oder Aktualisierungsvorgängen auftreten.

EnablePersistedSelection

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Auswahl einer Zeile auf Index oder auf Datenschlüsselwerten basiert.

EnableSortingAndPagingCallbacks

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob clientseitige Rückrufe für Sortier- und Pagingvorgänge verwendet werden.

EnableTheming

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

(Geerbt von WebControl)
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)
Font

Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind.

(Geerbt von WebControl)
FooterRow

Ruft ein GridViewRow Objekt ab, das die Fußzeile in einem GridView Steuerelement darstellt.

FooterStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der Fußzeile in einem GridView Steuerelement festlegen können.

ForeColor

Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest.

(Geerbt von WebControl)
GridLines

Ruft die Gitternetzlinienart für ein GridView Steuerelement ab oder legt diese fest.

HasAttributes

Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat.

(Geerbt von WebControl)
HasChildViewState

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

(Geerbt von Control)
HeaderRow

Ruft ein GridViewRow Objekt ab, das die Kopfzeile in einem GridView Steuerelement darstellt.

HeaderStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der Kopfzeile in einem GridView Steuerelement festlegen können.

Height

Ruft die Höhe des Webserversteuerelements ab oder legt sie fest.

(Geerbt von WebControl)
HorizontalAlign

Dient zum Abrufen oder Festlegen der horizontalen Ausrichtung eines GridView Steuerelements auf der Seite.

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)
Initialized

Ruft einen Wert ab, der angibt, ob das datengebundene Steuerelement initialisiert wurde.

(Geerbt von BaseDataBoundControl)
InsertMethod

Dient zum Abrufen oder Festlegen des Namens der Methode, die aufgerufen werden soll, um Daten einzufügen.

(Geerbt von CompositeDataBoundControl)
IsBoundUsingDataSourceID

Ruft einen Wert ab, der angibt, ob die DataSourceID Eigenschaft festgelegt ist.

(Geerbt von BaseDataBoundControl)
IsChildControlStateCleared

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

(Geerbt von Control)
IsDataBindingAutomatic

Ruft einen Wert ab, der angibt, ob die Datenbindung automatisch ist.

(Geerbt von BaseDataBoundControl)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.

(Geerbt von WebControl)
IsTrackingViewState

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

(Geerbt von Control)
IsUsingModelBinders

Ruft einen Wert ab, der angibt, ob die Modellbindung verwendet wird.

(Geerbt von CompositeDataBoundControl)
IsViewStateEnabled

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

(Geerbt von Control)
ItemType

Dient zum Abrufen oder Festlegen des Namens des Datentyps für eine stark typierte Datenbindung.

(Geerbt von DataBoundControl)
LoadViewStateByID

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

(Geerbt von Control)
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)
PageCount

Ruft die Anzahl der Seiten ab, die zum Anzeigen der Datensätze der Datenquelle in einem GridView Steuerelement erforderlich sind.

PageIndex

Ruft den Index der aktuell angezeigten Seite ab oder legt den Index fest.

PagerSettings

Ruft einen Verweis auf das PagerSettings Objekt ab, mit dem Sie die Eigenschaften der Pagerschaltflächen in einem GridView Steuerelement festlegen können.

PagerStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der Pagerzeile in einem GridView Steuerelement festlegen können.

PagerTemplate

Dient zum Abrufen oder Festlegen des benutzerdefinierten Inhalts für die Pagerzeile in einem GridView Steuerelement.

PageSize

Dient zum Abrufen oder Festlegen der Anzahl von Datensätzen, die auf einer Seite in einem GridView Steuerelement angezeigt werden sollen.

Parent

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

(Geerbt von Control)
RenderingCompatibility

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

(Geerbt von Control)
RequiresDataBinding

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die DataBind() Methode aufgerufen werden soll.

(Geerbt von BaseDataBoundControl)
RowHeaderColumn

Ruft den Namen der Spalte ab, die als Spaltenüberschrift für das GridView Steuerelement verwendet werden soll, oder legt diesen fest. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.

Rows

Ruft eine Auflistung von GridViewRow Objekten ab, die die Datenzeilen in einem GridView Steuerelement darstellen.

RowStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der Datenzeilen in einem GridView Steuerelement festlegen können.

SelectArguments

Ruft ein DataSourceSelectArguments Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellensteuerelement verwendet wird.

(Geerbt von DataBoundControl)
SelectedDataKey

Ruft das DataKey Objekt ab, das den Datenschlüsselwert für die ausgewählte Zeile in einem GridView Steuerelement enthält.

SelectedIndex

Ruft den Index der ausgewählten Zeile in einem GridView Steuerelement ab oder legt den Index fest.

SelectedPersistedDataKey

Dient zum Abrufen oder Festlegen des Datenschlüsselwerts für das beibehaltene ausgewählte Element in einem GridView Steuerelement.

SelectedRow

Ruft einen Verweis auf ein GridViewRow Objekt ab, das die ausgewählte Zeile im Steuerelement darstellt.

SelectedRowStyle

Ruft einen Verweis auf das TableItemStyle Objekt ab, mit dem Sie die Darstellung der ausgewählten Zeile in einem GridView Steuerelement festlegen können.

SelectedValue

Ruft den Datenschlüsselwert der ausgewählten Zeile in einem GridView Steuerelement ab.

SelectMethod

Der Name der Methode, die aufgerufen werden soll, um Daten zu lesen.

(Geerbt von DataBoundControl)
ShowFooter

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Fußzeile in einem GridView Steuerelement angezeigt wird.

ShowHeader

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Kopfzeile in einem GridView Steuerelement angezeigt wird.

ShowHeaderWhenEmpty

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Überschrift einer Spalte im GridView Steuerelement sichtbar ist, wenn die Spalte keine Daten enthält.

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 WebControl)
SortDirection

Ruft die Sortierrichtung der spalte ab, die sortiert wird.

SortedAscendingCellStyle

Ruft die CSS-Formatvorlage für eine GridView Spalte ab, wenn die Spalte in aufsteigender Reihenfolge sortiert wird, oder legt diese fest.

SortedAscendingHeaderStyle

Ruft die CSS-Formatvorlage ab, die auf eine GridView Spaltenüberschrift angewendet werden soll, wenn die Spalte in aufsteigender Reihenfolge sortiert wird, oder legt diese fest.

SortedDescendingCellStyle

Ruft die Formatvorlage einer GridView Spalte ab, wenn die Spalte in absteigender Reihenfolge sortiert wird, oder legt diese fest.

SortedDescendingHeaderStyle

Ruft die Formatvorlage ab, die auf eine GridView Spaltenüberschrift angewendet werden soll, wenn die Spalte in absteigender Reihenfolge sortiert wird, oder legt diese fest.

SortExpression

Ruft den Sortierausdruck ab, der der Spalte oder den Spalten zugeordnet ist, die sortiert werden.

Style

Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob das Steuerelement das disabled Attribut des gerenderten HTML-Elements auf "disabled" festlegen soll, wenn die Eigenschaft des Steuerelements IsEnabled ist false.

(Geerbt von BaseDataBoundControl)
TabIndex

Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements.

(Geerbt von WebControl)
TagKey

Ruft den HtmlTextWriterTag Wert für das GridView Steuerelement ab.

TagName

Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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)
ToolTip

Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest.

(Geerbt von WebControl)
TopPagerRow

Ruft ein GridViewRow Objekt ab, das die oberste Pagerzeile in einem GridView Steuerelement darstellt.

UniqueID

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

(Geerbt von Control)
UpdateMethod

Dient zum Abrufen oder Festlegen des Namens der Methode, die aufgerufen werden soll, um Daten zu aktualisieren.

UseAccessibleHeader

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein GridView Steuerelement seine Kopfzeile in einem barrierefreien Format rendert. Diese Eigenschaft wird bereitgestellt, um die Steuerung für Benutzer von Hilfstechnologiegeräten zugänglicher zu machen.

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)
VirtualItemCount

Dient zum Abrufen oder Festlegen der virtuellen Anzahl von Elementen in der Datenquelle, an die das GridView Steuerelement gebunden ist, wenn benutzerdefinierte Paging verwendet wird.

Visible

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

(Geerbt von Control)
Width

Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements.

(Geerbt von WebControl)

Methoden

Name Beschreibung
AddAttributesToRender(HtmlTextWriter)

Fügt HTML-Attribute und -Formatvorlagen hinzu, die dem angegebenen Element HtmlTextWriterTaggerendert werden müssen. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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)
ConfirmInitState()

Legt den initialisierten Zustand des datengebundenen Steuerelements fest.

(Geerbt von BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CreateAutoGeneratedColumn(AutoGeneratedFieldProperties)
Veraltet.

Erstellt ein automatisch generiertes Spaltenfeld.

CreateChildControls()

Erstellt die Steuerelementhierarchie, die zum Rendern eines zusammengesetzten datengebundenen Steuerelements verwendet wird, basierend auf den Werten, die im Ansichtszustand gespeichert sind.

(Geerbt von CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Erstellt die Steuerelementhierarchie, die zum Rendern des GridView Steuerelements mithilfe der angegebenen Datenquelle verwendet wird.

CreateChildTable()

Erstellt eine neue untergeordnete Tabelle.

CreateColumns(PagedDataSource, Boolean)

Erstellt den Satz von Spaltenfeldern, die zum Erstellen der Steuerelementhierarchie verwendet werden.

CreateControlCollection()

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

(Geerbt von Control)
CreateControlStyle()

Erstellt die Standardformatvorlage für das Steuerelement.

CreateDataSourceSelectArguments()

Erstellt das DataSourceSelectArguments Objekt, das die Argumente enthält, die zur Verarbeitung an die Datenquelle übergeben werden.

CreateRow(Int32, Int32, DataControlRowType, DataControlRowState)

Erstellt eine Zeile im GridView Steuerelement.

DataBind()

Bindet die Datenquelle an das GridView Steuerelement. Diese Methode kann nicht geerbt werden.

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)
DeleteRow(Int32)

Löscht den Datensatz am angegebenen Index aus der Datenquelle.

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)
EnsureDataBound()

Ruft die DataBind() Methode auf, wenn die DataSourceID Eigenschaft festgelegt ist und das datengebundene Steuerelement als Bindung gekennzeichnet ist.

(Geerbt von BaseDataBoundControl)
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)
ExtractRowValues(IOrderedDictionary, GridViewRow, Boolean, Boolean)

Ruft die Werte jedes Felds ab, das in der angegebenen Zeile deklariert ist, und speichert sie im angegebenen IOrderedDictionary Objekt.

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)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetCallbackResult()

Gibt das Ergebnis eines Rückrufereignisses zurück, das auf ein Steuerelement ausgerichtet ist.

GetCallbackScript(IButtonControl, String)

Erstellt das Rückrufskript für eine Schaltfläche, die einen Sortiervorgang ausführt.

GetData()

Ruft ein DataSourceView Objekt ab, das vom datengebundenen Steuerelement zum Ausführen von Datenvorgängen verwendet wird.

(Geerbt von DataBoundControl)
GetDataSource()

Ruft die IDataSource Schnittstelle ab, der das datengebundene Steuerelement zugeordnet ist, falls vorhanden.

(Geerbt von DataBoundControl)
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)
InitializePager(GridViewRow, Int32, PagedDataSource)

Initialisiert die Pagerzeile, die angezeigt wird, wenn das Paging-Feature aktiviert ist.

InitializeRow(GridViewRow, DataControlField[])

Initialisiert eine Zeile im GridView Steuerelement.

IsBindableType(Type)

Bestimmt, ob der angegebene Datentyp an eine Spalte in einem GridView Steuerelement gebunden werden kann.

IsLiteralContent()

Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält.

(Geerbt von Control)
LoadControlState(Object)

Lädt den Status der Eigenschaften im GridView Steuerelement, die beibehalten werden müssen, auch wenn die EnableViewState Eigenschaft auf false".

LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des GridView Steuerelements.

MapPathSecure(String)

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

(Geerbt von Control)
MarkAsDataBound()

Legt den Status des Steuerelements im Ansichtszustand als erfolgreich an Daten gebunden fest.

(Geerbt von DataBoundControl)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Webserversteuerelement an die Benutzeroberflächen-Serversteuerelementhierarchie der Seite übergeben wird.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Löst das CreatingModelDataSource-Ereignis aus.

(Geerbt von DataBoundControl)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnDataBound(EventArgs)

Löst das DataBound-Ereignis aus.

(Geerbt von BaseDataBoundControl)
OnDataPropertyChanged()

Binden Sie das GridView Steuerelement an seine Daten neu, nachdem die DataMemberEigenschaft DataSourcegeändert DataSourceID wurde.

OnDataSourceViewChanged(Object, EventArgs)

Löst das DataSourceViewChanged-Ereignis aus.

OnInit(EventArgs)

Löst das Init-Ereignis aus.

OnLoad(EventArgs)

Behandelt das Load Ereignis.

(Geerbt von DataBoundControl)
OnPageIndexChanged(EventArgs)

Löst das PageIndexChanged-Ereignis aus.

OnPageIndexChanging(GridViewPageEventArgs)

Löst das PageIndexChanging-Ereignis aus.

OnPagePreLoad(Object, EventArgs)

Legt den initialisierten Zustand des datengebundenen Steuerelements fest, bevor das Steuerelement geladen wird.

OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

OnRowCancelingEdit(GridViewCancelEditEventArgs)

Löst das RowCancelingEdit-Ereignis aus.

OnRowCommand(GridViewCommandEventArgs)

Löst das RowCommand-Ereignis aus.

OnRowCreated(GridViewRowEventArgs)

Löst das RowCreated-Ereignis aus.

OnRowDataBound(GridViewRowEventArgs)

Löst das RowDataBound-Ereignis aus.

OnRowDeleted(GridViewDeletedEventArgs)

Löst das RowDeleted-Ereignis aus.

OnRowDeleting(GridViewDeleteEventArgs)

Löst das RowDeleting-Ereignis aus.

OnRowEditing(GridViewEditEventArgs)

Löst das RowEditing-Ereignis aus.

OnRowUpdated(GridViewUpdatedEventArgs)

Löst das RowUpdated-Ereignis aus.

OnRowUpdating(GridViewUpdateEventArgs)

Löst das RowUpdating-Ereignis aus.

OnSelectedIndexChanged(EventArgs)

Löst das SelectedIndexChanged-Ereignis aus.

OnSelectedIndexChanging(GridViewSelectEventArgs)

Löst das SelectedIndexChanging-Ereignis aus.

OnSorted(EventArgs)

Löst das Sorted-Ereignis aus.

OnSorting(GridViewSortEventArgs)

Löst das Sorting-Ereignis aus.

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)
PerformDataBinding(IEnumerable)

Bindet die angegebene Datenquelle an das GridView Steuerelement.

PerformSelect()

Ruft Daten aus der zugeordneten Datenquelle ab.

(Geerbt von DataBoundControl)
PrepareControlHierarchy()

Richtet die Steuerelementhierarchie ein.

RaiseBubbleEvent(Object, EventArgs)

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

(Geerbt von Control)
RaiseCallbackEvent(String)

Erstellt die Argumente für den Rückrufhandler in der GetCallbackEventReference(Control, String, String, String, Boolean) Methode.

RaisePostBackEvent(String)

Löst die entsprechenden Ereignisse für das GridView Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird.

RemovedControl(Control)

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

(Geerbt von Control)
Render(HtmlTextWriter)

Rendert den Inhalt des Webserversteuerelements mithilfe des angegebenen HtmlTextWriter Objekts im Browser des Clients.

RenderBeginTag(HtmlTextWriter)

Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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 Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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)
RenderEndTag(HtmlTextWriter)

Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
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 GridView Steuerelement, die beibehalten werden müssen, auch wenn die EnableViewState Eigenschaft auf false".

SaveViewState()

Lädt den zuvor gespeicherten Ansichtszustand des GridView Steuerelements.

SelectRow(Int32)

Wählt die Zeile aus, die in einem GridView Steuerelement bearbeitet werden soll.

SetDesignModeState(IDictionary)

Legt Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetEditRow(Int32)

Platziert eine Zeile im Bearbeitungsmodus in einem GridView Steuerelement mithilfe des angegebenen Zeilenindexes.

SetPageIndex(Int32)

Legt den Seitenindex des GridView Steuerelements mithilfe des Zeilenindex 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)
Sort(String, SortDirection)

Sortiert das GridView Steuerelement basierend auf dem angegebenen Sortierausdruck und der angegebenen Richtung.

ToString()

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

(Geerbt von Object)
TrackViewState()

Verfolgt Änderungen am Ansichtszustand des GridView Steuerelements, sodass sie im Objekt des Steuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden.

UpdateRow(Int32, Boolean)

Aktualisiert den Datensatz am angegebenen Zeilenindex mithilfe der Feldwerte der Zeile.

ValidateDataSource(Object)

Überprüft, ob das Objekt, an das ein datengebundenes Steuerelement gebunden ist, einer ist, mit dem es arbeiten kann.

(Geerbt von DataBoundControl)

Ereignisse

Name Beschreibung
CallingDataMethods

Tritt auf, wenn Datenmethoden aufgerufen werden.

(Geerbt von DataBoundControl)
CreatingModelDataSource

Tritt auf, wenn das ModelDataSource Objekt erstellt wird.

(Geerbt von DataBoundControl)
DataBinding

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

(Geerbt von Control)
DataBound

Tritt ein, nachdem das Serversteuerelement eine Bindung an eine Datenquelle hat.

(Geerbt von BaseDataBoundControl)
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)
PageIndexChanged

Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber nachdem das GridView Steuerelement den Auslagerungsvorgang verarbeitet hat.

PageIndexChanging

Tritt auf, wenn auf eine der Pagerschaltflächen geklickt wird, aber bevor das GridView Steuerelement den Auslagerungsvorgang behandelt.

PreRender

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

(Geerbt von Control)
RowCancelingEdit

Tritt auf, wenn auf die Schaltfläche "Abbrechen" einer Zeile im Bearbeitungsmodus geklickt wird, aber bevor die Zeile den Bearbeitungsmodus verlässt.

RowCommand

Tritt auf, wenn auf eine Schaltfläche in einem GridView Steuerelement geklickt wird.

RowCreated

Tritt auf, wenn eine Zeile in einem GridView Steuerelement erstellt wird.

RowDataBound

Tritt auf, wenn eine Datenzeile an Daten in einem GridView Steuerelement gebunden ist.

RowDeleted

Tritt auf, wenn auf die Schaltfläche "Löschen" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement die Zeile löscht.

RowDeleting

Tritt auf, wenn auf die Schaltfläche "Löschen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement die Zeile löscht.

RowEditing

Tritt auf, wenn auf die Schaltfläche "Bearbeiten" einer Zeile geklickt wird, aber bevor das GridView Steuerelement in den Bearbeitungsmodus wechselt.

RowUpdated

Tritt auf, wenn auf die Schaltfläche "Aktualisieren" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement die Zeile aktualisiert hat.

RowUpdating

Tritt auf, wenn auf die Schaltfläche "Aktualisieren" einer Zeile geklickt wird, aber bevor das GridView Steuerelement die Zeile aktualisiert.

SelectedIndexChanged

Tritt auf, wenn auf die Schaltfläche "Auswählen" einer Zeile geklickt wird, aber nachdem das GridView Steuerelement den Auswahlvorgang behandelt hat.

SelectedIndexChanging

Tritt auf, wenn auf die Schaltfläche "Auswählen" einer Zeile geklickt wird, aber bevor das GridView Steuerelement den Auswahlvorgang behandelt.

Sorted

Tritt auf, wenn auf den Link zum Sortieren einer Spalte geklickt wird, aber nachdem das GridView Steuerelement den Sortiervorgang behandelt hat.

Sorting

Tritt auf, wenn auf den Link zum Sortieren einer Spalte geklickt wird, aber bevor das GridView Steuerelement den Sortiervorgang behandelt.

Unload

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

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.

(Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)

Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest.

(Geerbt von WebControl)
ICallbackContainer.GetCallbackScript(IButtonControl, String)

Erstellt das Rückrufskript für eine Schaltfläche, die einen Sortiervorgang ausführt.

ICallbackEventHandler.GetCallbackResult()

Gibt das Ergebnis eines Rückrufereignisses zurück, das auf ein Steuerelement ausgerichtet ist.

ICallbackEventHandler.RaiseCallbackEvent(String)

Erstellt die Argumente für den Rückrufhandler in der GetCallbackEventReference(Control, String, String, String, Boolean) Methode.

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)
IDataBoundControl.DataKeyNames

Dient zum Abrufen oder Festlegen der Namen der Primärschlüsselfelder für die Elemente, die in einem datengebundenen Steuerelement angezeigt werden.

IDataBoundControl.DataMember

Dient zum Abrufen oder Festlegen der Tabelle, die vom Datenquellensteuerelement zum Binden an das datengebundene Steuerelement verfügbar gemacht wird.

IDataBoundControl.DataSource

Dient zum Abrufen oder Festlegen des Datenquellenobjekts, aus dem das datengebundene Steuerelement die Liste der Datenelemente abruft.

IDataBoundControl.DataSourceID

Ruft die ID der Datenquelle ab, aus der das datengebundene Steuerelement die Liste der Datenelemente abruft, oder legt diese fest.

IDataBoundControl.DataSourceObject

Dient zum Abrufen oder Festlegen des Datenquellenobjekts, aus dem das datengebundene Steuerelement die Liste der Datenelemente abruft.

IDataBoundListControl.ClientIDRowSuffix

Dient zum Abrufen oder Festlegen der Namen der Datenfelder, deren Werte an den ClientID Eigenschaftswert angefügt werden, um jede Instanz eines datengebundenen Steuerelements eindeutig zu identifizieren.

IDataBoundListControl.DataKeys

Ruft eine Auflistung von Objekten ab, die den DataKeys Wert in einem datengebundenen Steuerelement darstellen.

IDataBoundListControl.EnablePersistedSelection

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Auswahl einer Zeile auf Index oder auf Datenschlüsselwerten basiert.

IDataBoundListControl.SelectedDataKey

Ruft das Objekt ab, das den Datenschlüsselwert für die ausgewählte Zeile in einem datengebundenen Steuerelement enthält.

IDataBoundListControl.SelectedIndex

Ruft den Index der ausgewählten Zeile im datengebundenen Steuerelement ab oder legt den Index fest.

IDataKeysControl.ClientIDRowSuffixDataKeys

Ruft die Datenwerte ab, die verwendet werden, um jede Instanz eines datengebundenen Steuerelements eindeutig zu identifizieren, wenn ASP.NET den ClientID Wert generiert.

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)
IFieldControl.FieldsGenerator

Dient zum Abrufen oder Festlegen des Steuerelements, das automatisch die Spalten für ein datengebundenes Steuerelement für die Verwendung durch ASP.NET dynamische Daten generiert.

IParserAccessor.AddParsedSubObject(Object)

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

(Geerbt von Control)
IPersistedSelector.DataKey

Eine Beschreibung dieses Mitglieds finden Sie unter DataKey.

IPostBackContainer.GetPostBackOptions(IButtonControl)

Erstellt ein PostBackOptions Objekt, das das Postbackverhalten des angegebenen Schaltflächensteuerelements darstellt.

IPostBackEventHandler.RaisePostBackEvent(String)

Löst die entsprechenden Ereignisse für das GridView Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird.

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.

EnablePersistedSelection(BaseDataBoundControl)
Veraltet.

Ermöglicht das Beibehalten der Auswahl in Datensteuerelementen, die auswahl und Paging unterstützen.

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