Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataGrid-Klasse

.NET Framework 4

Ein datengebundenes Listensteuerelement, das die Elemente aus einer Datenquelle in einer Tabelle anzeigt. Mit dem DataGrid-Steuerelement können Sie diese Elemente auswählen, sortieren und bearbeiten.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataList
        System.Web.UI.WebControls.DataGrid

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Kopieren 
public class DataGrid : BaseDataList, INamingContainer
ASP.NET
Kopieren 
<asp:DataGrid />

Der DataGrid-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode DataGrid Initialisiert eine neue Instanz der DataGrid-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft AccessKey Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Von WebControl geerbt.)
Geschützte Eigenschaft Adapter Ruft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
Öffentliche Eigenschaft AllowCustomPaging Ruft einen Wert ab, der angibt, ob die benutzerdefinierte Paginierung aktiviert ist, oder legt diesen fest.
Öffentliche Eigenschaft AllowPaging Ruft einen Wert ab, der angibt, ob die Paginierung aktiviert ist, oder legt diesen fest.
Öffentliche Eigenschaft AllowSorting Ruft einen Wert ab, der angibt, ob das Sortieren aktiviert ist, oder legt diesen fest.
Öffentliche Eigenschaft AlternatingItemStyle Ruft die Stileigenschaften für abwechselnde Elemente im DataGrid-Steuerelement ab.
Öffentliche Eigenschaft AppRelativeTemplateSourceDirectory Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Von Control geerbt.)
Öffentliche Eigenschaft Attributes Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Von WebControl geerbt.)
Öffentliche Eigenschaft AutoGenerateColumns Ruft einen Wert ab, der angibt, ob BoundColumn-Objekte im DataGrid-Steuerelement für jedes Feld in der Datenquelle automatisch erstellt und angezeigt werden, oder legt diesen fest.
Öffentliche Eigenschaft BackColor Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft BackImageUrl Ruft die URL eines Bildes ab, das im Hintergrund des DataGrid-Steuerelements angezeigt werden soll, oder legt diese fest.
Öffentliche Eigenschaft BindingContainer Infrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
Öffentliche Eigenschaft BorderColor Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft BorderStyle Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft BorderWidth Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft Caption Ruft den Text ab, der in einem HTML-Beschriftungselement im Steuerelement gerendert werden soll, oder legt diesen Text fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft CaptionAlign Ruft die horizontale oder die vertikale Position des HTML-Beschriftungselements in einem Steuerelement ab oder legt diese fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft CellPadding Ruft den Abstand zwischen dem Inhalt einer Zelle und ihrem Rahmen ab oder legt diesen fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft CellSpacing Ruft den Abstand zwischen den Zellen ab oder legt diesen fest. (Von BaseDataList geerbt.)
Geschützte Eigenschaft ChildControlsCreated Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
Öffentliche Eigenschaft ClientID Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Von Control geerbt.)
Öffentliche Eigenschaft ClientIDMode Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Von Control geerbt.)
Geschützte Eigenschaft ClientIDSeparator Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Von Control geerbt.)
Öffentliche Eigenschaft Columns Ruft eine Auflistung von Objekten ab, die die Spalten des DataGrid-Steuerelements darstellen.
Geschützte Eigenschaft Context Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Von Control geerbt.)
Öffentliche Eigenschaft Controls Ruft ein System.Web.UI.ControlCollection-Objekt ab, das eine Auflistung von untergeordneten Steuerelementen eines Datenauflistungssteuerelements enthält. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft ControlStyle Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche Eigenschaft ControlStyleCreated Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche Eigenschaft CssClass Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft CurrentPageIndex Ruft den Index der derzeit angezeigten Seite ab oder legt diesen fest.
Öffentliche Eigenschaft DataItemContainer Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Von Control geerbt.)
Öffentliche Eigenschaft DataKeyField Ruft das Schlüsselfeld in der Datenquelle ab, die von der DataSource-Eigenschaft angegeben wurde, oder legt dieses fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft DataKeys Ruft ein DataKeyCollection-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement gespeichert sind. (Von BaseDataList geerbt.)
Geschützte Eigenschaft DataKeysArray Ruft ein ArrayList-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement enthalten sind. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft DataKeysContainer Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Von Control geerbt.)
Öffentliche Eigenschaft DataMember Ruft in einer Datenquelle mit mehreren Membern einen bestimmten Datenmember ab, der an ein Datenauflistungssteuerelement gebunden werden soll, oder legt diesen fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft DataSource Ruft die Quelle mit einer Werteliste ab, die zum Auffüllen der Elemente im Steuerelement verwendet wird, oder legt diese fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft DataSourceID Ruft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest. (Von BaseDataList geerbt.)
Geschützte Eigenschaft DesignMode Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
Öffentliche Eigenschaft EditItemIndex Ruft den Index eines Elements im zu bearbeitenden DataGrid-Steuerelement ab oder legt diesen fest.
Öffentliche Eigenschaft EditItemStyle Ruft die Stileigenschaften für das zur Bearbeitung im DataGrid-Steuerelement ausgewählte Element ab.
Öffentliche Eigenschaft Enabled Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft EnableTheming Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft EnableViewState Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Von Control geerbt.)
Geschützte Eigenschaft Events Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
Öffentliche Eigenschaft Font Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Von WebControl geerbt.)
Öffentliche Eigenschaft FooterStyle Ruft die Stileigenschaften des Footerzeilenbereichs im DataGrid-Steuerelement ab.
Öffentliche Eigenschaft ForeColor Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft GridLines Ruft einen Wert ab, der angibt, ob der Rahmen zwischen den Zellen eines Datenauflistungssteuerelements angezeigt wird, oder legt diesen fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft HasAttributes Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Von WebControl geerbt.)
Geschützte Eigenschaft HasChildViewState Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Von Control geerbt.)
Öffentliche Eigenschaft HeaderStyle Ruft die Stileigenschaften des Headerzeilenbereichs im DataGrid-Steuerelement ab.
Öffentliche Eigenschaft Height Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft HorizontalAlign Ruft die horizontale Ausrichtung eines Datenauflistungssteuerelements in dessen Container ab oder legt diese fest. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft ID Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Von Control geerbt.)
Geschützte Eigenschaft IdSeparator Infrastruktur. Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Von Control geerbt.)
Geschützte Eigenschaft Initialized Ruft einen Wert ab, der angibt, ob das Steuerelement initialisiert wurde. (Von BaseDataList geerbt.)
Geschützte Eigenschaft IsBoundUsingDataSourceID Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist. (Von BaseDataList geerbt.)
Geschützte Eigenschaft IsChildControlStateCleared Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Von Control geerbt.)
Geschützte Eigenschaft IsEnabled Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Von WebControl geerbt.)
Geschützte Eigenschaft IsTrackingViewState Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
Geschützte Eigenschaft IsViewStateEnabled Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
Öffentliche Eigenschaft Items Ruft eine Auflistung der DataGridItem-Objekte ab, die die einzelnen Elemente im DataGrid-Steuerelement darstellen.
Öffentliche Eigenschaft ItemStyle Ruft die Stileigenschaften für die Elemente im DataGrid-Steuerelement ab.
Geschützte Eigenschaft LoadViewStateByID Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Von Control geerbt.)
Öffentliche Eigenschaft NamingContainer Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert unterschieden werden kann. (Von Control geerbt.)
Öffentliche Eigenschaft Page Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
Öffentliche Eigenschaft PageCount Ruft die Anzahl der für die Anzeige der Elemente im DataGrid-Steuerelement insgesamt benötigten Seiten ab.
Öffentliche Eigenschaft PagerStyle Ruft die Stileigenschaften für den Paginierungsbereich des DataGrid-Steuerelements ab.
Öffentliche Eigenschaft PageSize Ruft die Anzahl der Elemente ab, die auf einer einzelnen Seite des DataGrid-Steuerelements angezeigt werden sollen, oder legt diese fest.
Öffentliche Eigenschaft Parent Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
Öffentliche Eigenschaft RenderingCompatibility Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Von Control geerbt.)
Geschützte Eigenschaft RequiresDataBinding Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement an seine angegebene Datenquelle gebunden werden muss, oder legt diesen fest. (Von BaseDataList geerbt.)
Geschützte Eigenschaft SelectArguments Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft SelectedIndex Ruft den Index des ausgewählten Elements im DataGrid-Steuerelement ab oder legt diesen fest.
Öffentliche Eigenschaft SelectedItem Ruft ein DataGridItem-Objekt ab, das das im DataGrid-Steuerelement ausgewählte Element darstellt.
Öffentliche Eigenschaft SelectedItemStyle Ruft die Stileigenschaften für das derzeit im DataGrid-Steuerelement ausgewählte Element ab.
Öffentliche Eigenschaft ShowFooter Ruft einen Wert ab, der angibt, ob die Footerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest.
Öffentliche Eigenschaft ShowHeader Ruft einen Wert ab, der angibt, ob die Headerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest.
Öffentliche Eigenschaft Site Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Von Control geerbt.)
Öffentliche Eigenschaft SkinID Ruft die Skin ab, die auf das Steuerelement angewendet werden soll, oder legt diese fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft Style Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Von WebControl geerbt.)
Öffentliche Eigenschaft SupportsDisabledAttribute Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist. (Von BaseDataList geerbt.)
Öffentliche Eigenschaft TabIndex Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Von WebControl geerbt.)
Geschützte Eigenschaft TagKey Ruft den HtmlTextWriterTag-Wert für das DataGrid-Steuerelement ab. (Überschreibt WebControl.TagKey.)
Geschützte Eigenschaft TagName Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche Eigenschaft TemplateControl Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Von Control geerbt.)
Öffentliche Eigenschaft TemplateSourceDirectory Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Von Control geerbt.)
Öffentliche Eigenschaft ToolTip Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche Eigenschaft UniqueID Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
Öffentliche Eigenschaft UseAccessibleHeader Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement den zugehörigen Header in einem barrierefreien Format rendert, oder legt diesen Wert fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Geschützte Eigenschaft ViewState Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Von Control geerbt.)
Geschützte Eigenschaft ViewStateIgnoresCase Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Von Control geerbt.)
Öffentliche Eigenschaft ViewStateMode Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Von Control geerbt.)
Öffentliche Eigenschaft VirtualItemCount Ruft bei Verwendung von benutzerdefiniertem Paging die virtuelle Anzahl von Elementen im DataGrid-Steuerelement ab oder legt diese fest.
Öffentliche Eigenschaft Visible Ruft einen Wert ab, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite dargestellt wird, oder legt diesen fest. (Von Control geerbt.)
Öffentliche Eigenschaft Width Ruft die Breite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Zum Seitenanfang
  Name Beschreibung
Geschützte Methode AddAttributesToRender Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Formatvorlagen hinzu. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte Methode AddedControl Wird aufgerufen, nachdem ein untergeordnetes Steuerelement der Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Von Control geerbt.)
Geschützte Methode AddParsedSubObject Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element der ControlCollection-Auflistung des Serversteuerelements hinzu. (Von BaseDataList geerbt.)
Öffentliche Methode ApplyStyle Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche Methode ApplyStyleSheetSkin Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Von Control geerbt.)
Geschützte Methode BuildProfileTree Infrastruktur. Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Von Control geerbt.)
Geschützte Methode ClearCachedClientID Infrastruktur. Legt den zwischengespeicherten ClientID-Wert auf null fest. (Von Control geerbt.)
Geschützte Methode ClearChildControlState Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearChildState Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearChildViewState Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearEffectiveClientIDMode Infrastruktur. Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Von Control geerbt.)
Öffentliche Methode CopyBaseAttributes Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte Methode CreateChildControls Infrastruktur. Erstellt ein untergeordnetes Steuerelement unter Verwendung des Ansichtszustands. (Von BaseDataList geerbt.)
Geschützte Methode CreateColumnSet Erstellt den Satz von Spalten, der zum Erstellen der Steuerelementhierarchie verwendet werden soll. Wenn AutoGenerateColumns auf true festgelegt ist, werden die Spalten gemäß der Datenquelle erstellt und an den in der Columns-Auflistung definierten Spaltensatz angehängt.
Geschützte Methode CreateControlCollection Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (literale und Serversteuerelemente) des Serversteuerelements aufnehmen soll. (Von Control geerbt.)
Geschützte Methode CreateControlHierarchy Erstellt die Steuerelementhierarchie, die für das Rendering von DataGrid verwendet wird. (Überschreibt BaseDataList.CreateControlHierarchy(Boolean).)
Geschützte Methode CreateControlStyle Erstellt einen neuen Steuerelementstil. (Überschreibt WebControl.CreateControlStyle().)
Geschützte Methode CreateDataSourceSelectArguments Erstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden. (Von BaseDataList geerbt.)
Geschützte Methode CreateItem Erstellt ein DataGridItem-Objekt.
Öffentliche Methode DataBind() Bindet das Steuerelement und alle seine untergeordneten Steuerelemente an die angegebene Datenquelle. (Von BaseDataList geerbt.)
Geschützte Methode DataBind(Boolean) Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
Geschützte Methode DataBindChildren Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Öffentliche Methode Dispose Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Von Control geerbt.)
Geschützte Methode EnsureChildControls Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Von Control geerbt.)
Geschützte Methode EnsureDataBound Überprüft vor dem Aufrufen der DataBind-Methode, ob für das Datenauflistungssteuerelement eine Datenbindung erforderlich ist und ob ein gültiges Datenquellen-Steuerelement angegeben wurde. (Von BaseDataList geerbt.)
Geschützte Methode EnsureID Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode FindControl(String) Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter. (Von Control geerbt.)
Geschützte Methode FindControl(String, Int32) Infrastruktur. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Von Control geerbt.)
Öffentliche Methode Focus Legt den Eingabefokus auf ein Steuerelement fest. (Von Control geerbt.)
Geschützte Methode GetData Gibt ein durch IEnumerable implementiertes Objekt zurück, das die Datenquelle darstellt. (Von BaseDataList geerbt.)
Geschützte Methode GetDesignModeState Infrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetRouteUrl(Object) Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(RouteValueDictionary) Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(String, Object) Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(String, RouteValueDictionary) Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode GetUniqueIDRelativeTo Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
Öffentliche Methode HasControls Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Von Control geerbt.)
Geschützte Methode HasEvents Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Von Control geerbt.)
Geschützte Methode InitializeItem Initialisiert das angegebene DataGridItem-Objekt.
Geschützte Methode InitializePager Erstellt ein DataGridItem-Objekt, das die Pagingbenutzeroberfläche enthält.
Geschützte Methode IsLiteralContent Infrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
Geschützte Methode LoadControlState Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte Methode LoadViewState Lädt einen gespeicherten Zustand von DataGrid. (Überschreibt WebControl.LoadViewState(Object).)
Geschützte Methode MapPathSecure Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Von Control geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode MergeStyle Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte Methode OnBubbleEvent Bewegt das von einem Steuerelement im Container ausgelöste Ereignis in der Hierarchie der UI-Serversteuerelemente der Seite nach oben. (Überschreibt Control.OnBubbleEvent(Object, EventArgs).)
Geschützte Methode OnCancelCommand Löst das CancelCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnDataBinding Infrastruktur. Löst das DataBinding-Ereignis eines BaseDataList-Steuerelements aus. (Von BaseDataList geerbt.)
Geschützte Methode OnDataPropertyChanged Wird aufgerufen, wenn eine der Identifikationseigenschaften der Basisdatenquelle geändert wird, um das datengebundene Steuerelement erneut an seine Daten zu binden. (Von BaseDataList geerbt.)
Geschützte Methode OnDataSourceViewChanged Löst das DataSourceViewChanged-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte Methode OnDeleteCommand Löst das DeleteCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnEditCommand Löst das EditCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnInit Infrastruktur. Löst das Init-Ereignis für das BaseDataList-Steuerelement aus. (Von BaseDataList geerbt.)
Geschützte Methode OnItemCommand Löst das ItemCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnItemCreated Löst das ItemCreated-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnItemDataBound Löst das ItemDataBound-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnLoad Infrastruktur. Löst das Load-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte Methode OnPageIndexChanged Löst das PageIndexChanged-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnPreRender Infrastruktur. Löst das PreRender-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte Methode OnSelectedIndexChanged Löst das SelectedIndexChanged-Ereignis eines BaseDataList-Steuerelements aus. (Von BaseDataList geerbt.)
Geschützte Methode OnSortCommand Löst das SortCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OnUnload Löst das Unload-Ereignis aus. (Von Control geerbt.)
Geschützte Methode OnUpdateCommand Löst das UpdateCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte Methode OpenFile Ruft einen Stream zum Lesen einer Datei ab. (Von Control geerbt.)
Geschützte Methode PrepareControlHierarchy Infrastruktur. Richtet die Steuerelementhierarchie für dieses DataGrid-Steuerelement ein. (Überschreibt BaseDataList.PrepareControlHierarchy().)
Geschützte Methode RaiseBubbleEvent Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Von Control geerbt.)
Geschützte Methode RemovedControl Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Von Control geerbt.)
Geschützte Methode Render Infrastruktur. Gibt das Steuerelement im angegebenen HTML-Writer wieder. (Von BaseDataList geerbt.)
Öffentliche Methode RenderBeginTag Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte Methode RenderChildren Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
Geschützte Methode RenderContents Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Öffentliche Methode RenderControl(HtmlTextWriter) Gibt den Inhalt des Serversteuerelements an ein angegebenes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Von Control geerbt.)
Geschützte Methode RenderControl(HtmlTextWriter, ControlAdapter) Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten ControlAdapter-Objekts an ein bereitgestelltes HtmlTextWriter-Objekt aus. (Von Control geerbt.)
Öffentliche Methode RenderEndTag Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte Methode ResolveAdapter Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Von Control geerbt.)
Öffentliche Methode ResolveClientUrl Ruft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
Öffentliche Methode ResolveUrl Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Von Control geerbt.)
Geschützte Methode SaveControlState Speichert alle Änderungen am Zustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte Methode SaveViewState Speichert den aktuellen Zustand von DataGrid. (Überschreibt WebControl.SaveViewState().)
Geschützte Methode SetDesignModeState Legt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
Öffentliche Methode SetRenderMethodDelegate Infrastruktur. Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Von Control geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte Methode TrackViewState Markiert den Anfangspunkt, an dem mit dem Verfolgen und Speichern von Änderungen am Steuerelement im Rahmen des Ansichtszustands des Steuerelements begonnen wird. (Überschreibt WebControl.TrackViewState().)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis CancelCommand Tritt ein, wenn auf die Schaltfläche Cancel für ein Element im DataGrid-Steuerelement geklickt wird.
Öffentliches Ereignis DataBinding Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Von Control geerbt.)
Öffentliches Ereignis DeleteCommand Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Löschen geklickt wird.
Öffentliches Ereignis Disposed Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Von Control geerbt.)
Öffentliches Ereignis EditCommand Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Bearbeiten geklickt wird.
Öffentliches Ereignis Init Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
Öffentliches Ereignis ItemCommand Tritt ein, wenn auf eine beliebige Schaltfläche im DataGrid-Steuerelement geklickt wird.
Öffentliches Ereignis ItemCreated Tritt auf dem Server ein, wenn im DataGrid-Steuerelement ein Element erstellt wird.
Öffentliches Ereignis ItemDataBound Tritt ein, nachdem ein Element an das DataGrid-Steuerelement datengebunden wurde.
Öffentliches Ereignis Load Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
Öffentliches Ereignis PageIndexChanged Tritt ein, wenn auf eines der Seitenauswahlelemente geklickt wird.
Öffentliches Ereignis PreRender Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Von Control geerbt.)
Öffentliches Ereignis SelectedIndexChanged Tritt ein, wenn in einem Datenauflistungssteuerelement zwischen Übermittlungen zum Server ein anderes Element ausgewählt wird. (Von BaseDataList geerbt.)
Öffentliches Ereignis SortCommand Tritt beim Sortieren einer Spalte ein.
Öffentliches Ereignis Unload Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Von Control geerbt.)
Öffentliches Ereignis UpdateCommand Tritt ein, wenn auf die Schaltfläche Update für ein Element im DataGrid-Steuerelement geklickt wird.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Erweiterungsmethode EnableDynamicData(Type) Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche Erweiterungsmethode EnableDynamicData(Type, Object) Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche Erweiterungsmethode EnableDynamicData(Type, IDictionary<String, Object>) Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche Erweiterungsmethode FindDataSourceControl Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode FindFieldTemplate Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode FindMetaTable Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode GetDefaultValues Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode GetMetaTable Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode SetMetaTable(MetaTable) Überladen. Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode SetMetaTable(MetaTable, IDictionary<String, Object>) Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode SetMetaTable(MetaTable, Object) Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode TryGetMetaTable Bestimmt, ob Tabellenmetadaten verfügbar sind. (Durch DynamicDataExtensions definiert.)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Feld Statischer Member CancelCommandName Stellt den Namen des Cancel-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member DeleteCommandName Stellt den Namen des Delete-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member EditCommandName Stellt den Namen des Edit-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member NextPageCommandArgument Stellt das Argument des Next-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member PageCommandName Stellt den Namen des Page-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member PrevPageCommandArgument Stellt das Argument des Prev-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member SelectCommandName Stellt den Namen des Select-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member SortCommandName Stellt den Namen des Sort-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches Feld Statischer Member UpdateCommandName Stellt den Namen des Update-Befehls dar. Dieses Feld ist schreibgeschützt.
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Methode IAttributeAccessor.GetAttribute Infrastruktur. Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Von WebControl geerbt.)
Explizite Schnittstellenimplementierung Private Methode IAttributeAccessor.SetAttribute Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Von WebControl geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IControlBuilderAccessor.ControlBuilder Eine Beschreibung dieses Members finden Sie unter der IControlBuilderAccessor.ControlBuilder-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.GetDesignModeState Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.GetDesignModeState-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.SetDesignModeState Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetDesignModeState-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.SetOwnerControl Infrastruktur. Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetOwnerControl-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IControlDesignerAccessor.UserData Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.UserData-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IDataBindingsAccessor.DataBindings Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.DataBindings-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IDataBindingsAccessor.HasDataBindings Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.HasDataBindings-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IExpressionsAccessor.Expressions Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.Expressions-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IExpressionsAccessor.HasExpressions Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.HasExpressions-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IParserAccessor.AddParsedSubObject Eine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)
Zum Seitenanfang

In diesem Thema:

Einführung

Verwenden Sie das DataGrid-Steuerelement, um die Felder einer Datenquelle als Spalten in einer Tabelle anzuzeigen. Jede Zeile im DataGrid-Steuerelement stellt einen Datensatz in der Datenquelle dar. Das DataGrid-Steuerelement unterstützt das Auswählen, Bearbeiten, Löschen, Paging und Sortieren.

Warnhinweis Vorsicht

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client gesendet werden, nach ausführbaren Skripts, SQL-Anweisungen oder anderem Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeaufforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Validierungs-Serversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.

Unterschiedliche Spaltentypen bestimmen das Verhalten der Spalten im Steuerelement. In der folgenden Tabelle werden die verschiedenen Spaltentypen aufgelistet, die verwendet werden können.

Spaltentyp

Beschreibungen

BoundColumn

Zeigt eine Spalte an, die an ein Feld in einer Datenquelle gebunden ist. Jedes Element in diesem Feld wird als Text angezeigt. Dies ist der Standardspaltentyp des DataGrid-Steuerelements.

ButtonColumn

Zeigt eine Befehlsschaltfläche für jedes Element in der Spalte an. Damit können Sie eine Spalte mit benutzerdefinierten Schaltflächen-Steuerelementen erstellen, z. B. die Schaltflächen Add und Remove.

EditCommandColumn

Zeigt eine Spalte an, die Bearbeitungsbefehle für jedes Element in der Spalte enthält.

HyperLinkColumn

Zeigt den Inhalt der einzelnen Elemente in der Spalte als Link an. Der Inhalt der Spalte kann an ein Feld in einer Datenquelle oder an statischen Text gebunden werden.

TemplateColumn

Zeigt jedes Element in der Spalte entsprechend einer angegebenen Vorlage an. Dadurch können Sie benutzerdefinierte Steuerelemente in der Spalte bereitstellen.

Standardmäßig ist die AutoGenerateColumns-Eigenschaft auf true festgelegt, wodurch für jedes Feld in der Datenquelle ein BoundColumn-Objekt erstellt wird. Die einzelnen Felder werden anschließend in der Reihenfolge, in der sie in der Datenquelle enthalten sind, als Spalte im DataGrid-Steuerelement gerendert.

Sie können auch manuell steuern, welche Spalte im DataGrid-Steuerelement dargestellt wird, indem Sie die AutoGenerateColumns-Eigenschaft auf false festlegen und dann die gewünschten Spalten zwischen Start- und Endtag von <Columns> aufführen. Die angegebenen Spalten werden der Columns-Auflistung in der Reihenfolge hinzugefügt, in der sie aufgeführt sind. Auf diese Weise können Sie die Spalten im DataGrid-Steuerelement programmgesteuert steuern.

Hinweis Hinweis

Die Reihenfolge, in der die Spalten im DataGrid-Steuerelement angezeigt werden, wird von der Reihenfolge der Spalten in der Columns-Auflistung bestimmt. Sie können zwar die Reihenfolge der Spalten programmgesteuert ändern, indem Sie die Columns-Auflistung bearbeiten, es ist jedoch einfacher, die Spalten in der gewünschten Anzeigereihenfolge anzugeben.

Explizit deklarierte Spalten können zusammen mit automatisch erstellten Spalten angezeigt werden. Wenn Sie beide Spaltenarten verwenden, werden explizit deklarierte Spalten zuerst gerendert und anschließend die automatisch erstellten Spalten.

Hinweis Hinweis

Automatisch erstellte Spalten werden der Columns-Auflistung nicht hinzugefügt.

Die Darstellung des DataGrid-Steuerelements kann durch Festlegen der Stileigenschaften für die unterschiedlichen Teile des Steuerelements angepasst werden. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgelistet.

Style-Eigenschaft

Beschreibungen

AlternatingItemStyle

Gibt den Stil für abwechselnde Elemente im DataGrid-Steuerelement an.

EditItemStyle

Gibt den Stil für das im DataGrid-Steuerelement bearbeitete Element an.

FooterStyle

Gibt den Stil für den Footerzeilenbereich im DataGrid-Steuerelement an.

HeaderStyle

Gibt den Stil für den Headerzeilenbereich im DataGrid-Steuerelement an.

ItemStyle

Gibt den Stil für die Elemente im DataGrid-Steuerelement an.

PagerStyle

Gibt den Stil für den Seitenauswahlbereich des DataGrid-Steuerelements an.

SelectedItemStyle

Gibt den Stil für das im DataGrid-Steuerelement ausgewählte Element an.

Sie können auch verschiedene Bereiche des Steuerelements anzeigen und ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, mit denen gesteuert wird, welche Bereiche angezeigt oder ausgeblendet werden.

Property

Beschreibungen

ShowFooter

Zeigt den Footerzeilenbereich des DataGrid-Steuerelements an oder blendet diesen aus.

ShowHeader

Zeigt den Headerzeilenbereich des DataGrid-Steuerelements an oder blendet diesen aus.

Sie können die Darstellung des DataGrid-Steuerelements festlegen, indem Sie dem <td>-Tag und dem <tr>-Tag, die vom Steuerelement im Browser dargestellt werden, programmgesteuert Attribute hinzufügen. Attribute können programmgesteuert hinzugefügt werden, indem Sie im Ereignishandler für das OnItemCreated-Ereignis oder das OnItemDataBound-Ereignis Code bereitstellen.

Um dem <td>-Tag ein Attribut hinzuzufügen, rufen Sie zuerst das TableCell-Objekt ab, das die Zelle in dem DataGrid-Steuerelement darstellt, dem das Attribut hinzugefügt werden soll. Mit der Control.Controls-Auflistung für die Item-Eigenschaft des in den Ereignishandler übergebenen DataGridItemEventArgs-Objekts kann das gewünschte TableCell-Objekt abgerufen werden. Anschließend können Sie mit der AttributeCollection.Add-Methode der Attributes-Auflistung für das TableCell-Objekt dem <td>-Tag Attribute hinzufügen.

Um dem <tr>-Tag ein Attribut hinzuzufügen, rufen Sie zuerst das DataGridItem-Objekt ab, das die Zeile in dem DataGrid-Steuerelement darstellt, dem das Attribut hinzugefügt werden soll. Mit der Item-Eigenschaft des in den Ereignishandler übergebenen DataGridItemEventArgs-Objekts kann das gewünschte DataGridItem-Objekt abgerufen werden. Anschließend können Sie mit der AttributeCollection.Add-Methode der Attributes-Auflistung für das DataGridItem-Objekt dem <tr>-Tag Attribute hinzufügen.

Barrierefreiheit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das Standards für Barrierefreiheit entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und Steuerelemente und Barrierefreiheit von ASP.NET

Deklarative Syntax

Kopieren 
<asp:DataGrid
    AccessKey="string"
    AllowCustomPaging="True|False"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="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"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="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"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSortCommand="SortCommand event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    PageSize="integer"
    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"
>
        <AlternatingItemStyle />
        <Columns>
                <asp:BoundColumn
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ReadOnly="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundColumn>
                <asp:ButtonColumn
                    ButtonType="LinkButton|PushButton"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonColumn>
                <asp:EditCommandColumn
                    ButtonType="LinkButton|PushButton"
                    CancelText="string"
                    CausesValidation="True|False"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:EditCommandColumn>
                <asp:HyperLinkColumn
                    DataNavigateUrlField="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    NavigateUrl="uri"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkColumn>
                <asp:TemplateColumn
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Visible="True|False"
>
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateColumn>
        </Columns>
        <EditItemStyle />
        <FooterStyle />
        <HeaderStyle />
        <ItemStyle />
        <PagerStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            CssClass="string"
            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"
            Height="size"
            HorizontalAlign="NotSet|Left|Center|Right|Justify"
            Mode="NextPrev|NumericPages"
            NextPageText="string"
            OnDisposed="Disposed event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PrevPageText="string"
            VerticalAlign="NotSet|Top|Middle|Bottom"
            Visible="True|False"
            Width="size"
            Wrap="True|False"
        />
        <SelectedItemStyle />
</asp:DataGrid>

Zu diesem Thema steht ein Visual Studio-Websiteprojekt mit Quellcode zur Verfügung: Download.

Das folgende Codebeispiel veranschaulicht, wie mit dem DataGrid-Steuerelement die Elemente in der Datenquelle angezeigt werden können.

C#
VB
Kopieren 

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 

      </asp:DataGrid>

   </form>

</body>
</html>

Im folgenden Codebeispiel wird die Verwendung des DataGrid-Steuerelements für einen einfachen Warenkorb veranschaulicht.

C#
VB
Kopieren 

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">

      DataTable Cart;
      DataView CartView;

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         if (Session["DG4_ShoppingCart"] == null) 
         {
            Cart = new DataTable();
            Cart.Columns.Add(new DataColumn("Item", typeof(string)));
            Cart.Columns.Add(new DataColumn("Price", typeof(string)));
            Session["DG4_ShoppingCart"] = Cart;
         }

         else 
         {
            Cart = (DataTable)Session["DG4_ShoppingCart"];
         }    

         CartView = new DataView(Cart);
         ShoppingCart.DataSource = CartView;
         ShoppingCart.DataBind();

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {

         DataRow dr = Cart.NewRow();

         // e.Item is the table row where the command is raised.
         // For bound columns, the value is stored in the Text property of the TableCell.
         TableCell itemCell = e.Item.Cells[2];
         TableCell priceCell = e.Item.Cells[3];
         string item = itemCell.Text;
         string price = priceCell.Text;

         if (((Button)e.CommandSource).CommandName == "AddToCart") 
         {
            dr[0] = item;
            dr[1] = price;
            Cart.Rows.Add(dr);
         }

         else 
         {  

            // Remove from Cart.

            CartView.RowFilter = "Item='" + item + "'";
            if (CartView.Count > 0) 
            {     
               CartView.Delete(0);
            }
            CartView.RowFilter = "";
         }

         ShoppingCart.DataBind();

      }


   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

   <h3>DataGrid Example</h3>

   <table cellpadding="5">
      <tr valign="top">
         <td>

            <b>Product List</b>

            <asp:DataGrid id="ItemsGrid"
                 BorderColor="black"
                 BorderWidth="1"
                 CellPadding="3"
                 AutoGenerateColumns="false"
                 OnItemCommand="Grid_CartCommand"
                 runat="server">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

               <Columns>

                  <asp:ButtonColumn 
                       HeaderText="Add to cart" 
                       ButtonType="PushButton" 
                       Text="Add" 
                       CommandName="AddToCart" />

                  <asp:ButtonColumn 
                       HeaderText="Remove from cart" 
                       ButtonType="PushButton" 
                       Text="Remove" 
                       CommandName="RemoveFromCart" />

                  <asp:BoundColumn 
                       HeaderText="Item" 
                       DataField="StringValue"/>

                  <asp:BoundColumn 
                       HeaderText="Price" 
                       DataField="CurrencyValue" 
                       DataFormatString="{0:c}">

                     <ItemStyle HorizontalAlign="right">
                     </ItemStyle>

                  </asp:BoundColumn>   

               </Columns>

            </asp:DataGrid>

         </td>
         <td>

            <b>Shopping Cart</b>

            <asp:DataGrid id="ShoppingCart" 
                 runat="server"
                 BorderColor="black"
                 BorderWidth="1"
                 GridLines="Both"
                 ShowFooter="false"
                 CellPadding="3"
                 CellSpacing="0">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

            </asp:DataGrid> 

         </td>
      </tr>

   </table>

   </form>

</body>
</html>

Das folgende Codebeispiel veranschaulicht, wie Sie Attribute dynamisch den Tags <td> und <tr> hinzufügen, die vom DataGrid-Steuerelement generiert werden.

C#
VB
Kopieren


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">

   ICollection CreateDataSource() 
   {
      DataTable dt = new DataTable();
      DataRow dr;

      dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
      dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
      dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

      for (int i = 0; i < 5; i++) 
      {
         dr = dt.NewRow();

         dr[0] = i;
         dr[1] = "Item " + i.ToString();
         dr[2] = 1.23 * (i+1);

         dt.Rows.Add(dr);
      }

      DataView dv = new DataView(dt);
      return dv;
   }

   void Page_Load(Object sender, EventArgs e) 
   {

      if (!IsPostBack) 
      {
         // Load this data only once.
         ItemsGrid.DataSource = CreateDataSource();
         ItemsGrid.DataBind();
      }

   }

   void Item_Bound(Object sender, DataGridItemEventArgs e) 
   {

      ListItemType itemType = (ListItemType)e.Item.ItemType;

      if ((itemType != ListItemType.Header) &&
          (itemType != ListItemType.Footer) &&
          (itemType != ListItemType.Separator))
      {

         // Get the IntegerValue cell from the grid's column collection.
         TableCell intCell = (TableCell)e.Item.Controls[0];

         // Add attributes to the cell.
         intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString());
         intCell.Attributes.Add("OnClick", 
                                "Update_intCell" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

         // Add attributes to the row.
         e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString());
         e.Item.Attributes.Add("OnDblClick", 
                                "Update_row" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

      }

   }

</script>

<script type="text/vbscript">

   sub Update_intCell0 
      Alert "You Selected Cell 0."
   end sub

   sub Update_intCell1 
      Alert "You Selected Cell 1."
   end sub

   sub Update_intCell2 
      Alert "You Selected Cell 2."
   end sub

   sub Update_intCell3 
      Alert "You Selected Cell 3."
   end sub

   sub Update_intCell4 
      Alert "You Selected Cell 4."
   end sub

   sub UpDate_row0 
      Alert "You selected the row 0."
   end sub

   sub UpDate_row1 
      Alert "You selected the row 1."
   end sub

   sub UpDate_row2 
      Alert "You selected the row 2."
   end sub

   sub UpDate_row3 
      Alert "You selected the row 3."
   end sub

   sub UpDate_row4 
      Alert "You selected the row 4."
   end sub   

</script>

<head runat="server">
    <title>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; </title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; <br />
            Tags of a DataGrid Control
      </h3>

      <asp:DataGrid id="ItemsGrid" runat="server"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           ShowFooter="true"
           OnItemDataBound="Item_Bound"
           AutoGenerateColumns="false">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <FooterStyle BackColor="#00aaaa">
         </FooterStyle>

         <Columns>

            <asp:BoundColumn HeaderText="Number" 
                 DataField="IntegerValue">

               <ItemStyle BackColor="yellow">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:BoundColumn 
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="right">
               </ItemStyle>

            </asp:BoundColumn>

         </Columns>

      </asp:DataGrid>

      <br /><br />

      Click on one of the cells in the <b>Number</b> column to select the cell.

      <br /><br />

      Double click on a row to select a row.   

   </form>

</body>
</html>
C#
VB
Kopieren


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         // Populate the table with sample values.for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once when the page is first loaded.if (!IsPostBack) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Button_Click(Object sender, EventArgs e) 
      {

         // Count the number of selected items in the DataGrid control.int count = 0;

         // Display the selected times.
         Message.Text = "You Selected: <br />";

         // Iterate through each item (row) in the DataGrid control and // determine whether it is selected.foreach (DataGridItem item in ItemsGrid.Items)
         {

            DetermineSelection(item, ref count);        

         }

         // If no items are selected, display the appropriate message.if (count == 0)
         {

            Message.Text = "No items selected";

         }

      }

      void DetermineSelection(DataGridItem item, refint count)
      {

         // Retrieve the SelectCheckBox CheckBox control from the specified // item (row) in the DataGrid control.
         CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox");

         // If the item is selected, display the appropriate message and // increment the count of selected items.if (selection != null)
         {

           if (selection.Checked)
           {
              Message.Text += "- " + item.Cells[1].Text + "<br />";
              count++;
           }

         }    

      }

   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="False"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn DataField="IntegerValue" 
                 HeaderText="Item"/>

            <asp:BoundColumn DataField="StringValue" 
                 HeaderText="Description"/>

            <asp:BoundColumn DataField="CurrencyValue" 
                 HeaderText="Price"
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="Right">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

                  <asp:CheckBox id="SelectCheckBox"
                       Text="Add to Cart"
                       Checked="False"
                       runat="server"/>

               </ItemTemplate>

            </asp:TemplateColumn>

         </Columns> 

      </asp:DataGrid>

      <br /><br />

      <asp:Button id="SubmitButton"
           Text="Submit"
           OnClick = "Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Message"
           runat="server"/>

   </form>

</body>
</html>

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ