Spaltentypen im DataGridView-Steuerelement in Windows Forms
Aktualisiert: November 2007
Das DataGridView-Steuerelement verwendet verschiedene Spaltentypen, um deren Inhalt anzuzeigen und es Benutzern zu ermöglichen, Informationen zu ändern oder hinzuzufügen.
Wenn Sie ein DataGridView-Steuerelement binden und die AutoGenerateColumns-Eigenschaft auf true festlegen, werden Spalten automatisch anhand von standardmäßigen Spaltentypen generiert, die für die in der gebundenen Datenquelle enthaltenen Datentypen geeignet sind.
Sie können auch selbst Instanzen der Spaltenklassen erstellen und sie der von der Columns-Eigenschaft zurückgegebenen Auflistung hinzufügen. Sie können diese Instanzen zur Verwendung als ungebundene Spalten erstellen oder sie manuell binden. Manuell gebundene Spalten sind beispielsweise hilfreich, wenn Sie eine automatisch generierte Spalte eines bestimmten Typs durch eine Spalte eines anderen Typs ersetzen möchten.
In der folgenden Tabelle werden die verschiedenen Spaltenklassen beschrieben, die im DataGridView-Steuerelement verfügbar sind.
Klasse |
Beschreibung |
|---|---|
Wird mit textbasierten Werten verwendet. Wird beim Binden an Zahlen und Zeichenfolgen automatisch generiert. |
|
Wird mit Boolean-Werten und CheckState-Werten verwendet. Wird beim Binden an Werte dieser Typen automatisch generiert. |
|
Wird zur Anzeige von Bildern verwendet. Wird beim Binden an Bytearrays, Image-Objekte oder Icon-Objekte automatisch generiert. |
|
Wird zur Anzeige von Schaltflächen in Zellen verwendet. Wird beim Binden nicht automatisch generiert. Wird normalerweise als ungebundene Spalte verwendet. |
|
Wird zur Anzeige von Dropdownlisten in Zellen verwendet. Wird beim Binden nicht automatisch generiert. Wird normalerweise manuell an Daten gebunden. |
|
Wird zur Anzeige von Links in Zellen verwendet. Wird beim Binden nicht automatisch generiert. Wird normalerweise manuell an Daten gebunden. |
|
Der benutzerdefinierte Spaltentyp |
Sie können eine eigene Spaltenklasse erstellen, indem Sie die DataGridViewColumn-Klasse oder eine ihrer abgeleiteten Klassen erben, um benutzerdefiniertes Aussehen, Verhalten oder gehostete Steuerelemente bereitzustellen. Weitere Informationen finden Sie unter Gewusst wie: Anpassen von Zellen und Spalten im DataGridView-Steuerelement in Windows Forms durch Erweitern des Aussehens und Verhaltens |
Diese Spaltentypen werden in den folgenden Abschnitten ausführlich beschrieben.
DataGridViewTextBoxColumn
DataGridViewTextBoxColumn ist ein allgemeiner Spaltentyp für textbasierte Werte wie Zahlen und Zeichenfolgen. Im Bearbeitungsmodus wird ein TextBox-Steuerelement in der aktiven Zelle angezeigt, sodass die Benutzer den Zellenwert ändern können.
Zellenwerte werden zur Anzeige automatisch in Zeichenfolgen konvertiert. Vom Benutzer eingegebene oder geänderte Werte werden automatisch analysiert, um einen Zellenwert des entsprechenden Datentyps zu erstellen. Sie können diese Konvertierungen anpassen, indem Sie das CellFormatting-Ereignis und CellParsing-Ereignis des DataGridView-Steuerelements behandeln.
Der Zellenwertdatentyp einer Spalte wird in der ValueType-Eigenschaft der Spalte angegeben.
DataGridViewCheckBoxColumn
DataGridViewCheckBoxColumn wird mit Boolean-Werten und CheckState-Werten verwendet. Boolean-Werte werden als Kontrollkästchen mit zwei oder drei Zustanden angezeigt, je nach Wert der ThreeState-Eigenschaft. Wenn die Spalte an CheckState-Werte gebunden ist, lautet der ThreeState-Eigenschaftenwert standardmäßig true.
Für gewöhnlich dienen Kontrollkästchenzellenwerte entweder zum Speichern, ebenso wie andere Daten, oder zum Ausführen von Sammeloperationen. Wenn Sie sofort reagieren möchten, sobald ein Benutzer in eine Kontrollkästchenzelle klickt, können Sie das CellClick-Ereignis behandeln. Dieses Ereignis tritt jedoch auf, bevor der Zellenwert aktualisiert wird. Wenn Sie den neuen Wert bereits beim Klicken benötigen, besteht die Möglichkeit, den voraussichtlichen Wert anhand des aktuellen Werts zu berechnen. Ein anderer Ansatz sieht vor, dass Sie für die Änderung unverzüglich einen Commit ausführen und das CellValueChanged-Ereignis behandeln, um darauf zu reagieren. Um für die Änderung einen Commit auszuführen, wenn auf die Zelle geklickt wird, müssen Sie das CurrentCellDirtyStateChanged-Ereignis behandeln. Wenn die aktuelle Zelle eine Kontrollkästchenzelle ist, rufen Sie im Handler die CommitEdit-Methode auf, und übergeben Sie den Commit-Wert.
DataGridViewImageColumn
DataGridViewImageColumn wird zur Anzeige von Bildern verwendet. Bildspalten können wie folgt gefüllt werden: automatisch aus einer Datenquelle, manuell für ungebundene Spalten oder dynamisch in einem Handler für das CellFormatting-Ereignis.
Das automatische Füllen einer Bildspalte aus einer Datenquelle kann mit Bytearrays in verschiedenen Bildformaten erfolgen, einschließlich aller von der Image-Klasse unterstützen Formate und dem von Microsoft® Access und der Beispieldatenbank Northwind verwendeten OLE Picture-Format.
Eine Bildspalte manuell zu füllen bietet sich an, wenn Sie die Funktionalität einer DataGridViewButtonColumn bereitstellen, aber das Aussehen anpassen möchten. Sie können das DataGridView.CellClick-Ereignis behandeln, um auf Klicks in eine Bildzelle zu reagieren.
Das Füllen von Zellen einer Bildspalte in einem Handler für das CellFormatting-Ereignis ist hilfreich, wenn Sie Bilder für berechnete Werte oder Werte in einem anderen Format als einem Bildformat bereitstellen möchten. Möglicherweise verfügen Sie über eine Risikospalte mit den Zeichenfolgenwerten "high", "middle" und "low", die Sie als Symbole anzeigen möchten. Denkbar ist auch, dass Sie über eine Bildspalte verfügen, die anstelle des binären Inhalts der Bilder die Speicherorte von Bildern enthält, die geladen werden müssen.
DataGridViewButtonColumn
Mit DataGridViewButtonColumn können Sie eine Spalte mit Zellen anzeigen, die Schaltflächen enthalten. Dies bietet sich an, wenn Sie Benutzern die Möglichkeit geben möchten, Aktionen zu bestimmten Datensätzen auf einfache Weise auszuführen, z. B. das Erteilen eines Auftrags oder das Anzeigen von untergeordneten Datensätzen in einem separaten Fenster.
Schaltflächenspalten werden bei der Datenbindung eines DataGridView-Steuerelements nicht automatisch generiert. Um Schaltflächenspalten verwenden zu können, müssen Sie sie manuell erstellen und der von der DataGridView.Columns-Eigenschaft zurückgegebenen Auflistung hinzufügen.
Sie können auf das Klicken in Schaltflächenzellen reagieren, indem Sie das DataGridView.CellClick-Ereignis behandeln.
DataGridViewComboBoxColumn
Mit DataGridViewComboBoxColumn können Sie eine Spalte mit Zellen anzeigen, die Dropdown-Listenfelder enthalten. Dies ist für die Dateneingabe in Felder geeignet, die nur bestimmte Werte enthalten können, z. B. die Spalte Category der Tabelle Products in der Beispieldatenbank Northwind.
Sie können die für alle Zellen verwendete Dropdownliste auf die gleiche Weise füllen wie eine ComboBox-Dropdownliste, d. h. entweder manuell mit der von der Items-Eigenschaft zurückgegebenen Auflistung oder durch Binden an eine Datenquelle mithilfe der Eigenschaften DataSource, DisplayMember und ValueMember. Weitere Informationen finden Sie unter ComboBox-Steuerelement (Windows Forms).
Sie können die eigentlichen Zellenwerte an die vom DataGridView-Steuerelement verwendete Datenquelle binden, indem Sie die DataPropertyName-Eigenschaft der System.Windows.Forms.DataGridViewComboBoxColumn festlegen.
Kombinationsfeldspalten werden bei der Datenbindung eines DataGridView-Steuerelements nicht automatisch generiert. Um Kombinationsfeldspalten verwenden zu können, müssen Sie sie manuell erstellen und der von der Columns-Eigenschaft zurückgegebenen Auflistung hinzufügen.
DataGridViewLinkColumn
Mit DataGridViewLinkColumn können Sie eine Spalte mit Zellen anzeigen, die Hyperlinks enthalten. Dies bietet sich an, wenn die Datenquelle URL-Werte enthält, oder aber als Alternative zur Schaltflächenspalte für bestimmte Verhalten wie das Öffnen eines Fensters mit untergeordneten Datensätzen.
Linkspalten werden bei der Datenbindung eines DataGridView-Steuerelements nicht automatisch generiert. Um Linkspalten verwenden zu können, müssen Sie sie manuell erstellen und der von der Columns-Eigenschaft zurückgegebenen Auflistung hinzufügen.
Sie können auf Klicks auf Links reagieren, indem Sie das CellContentClick-Ereignis behandeln. Dieses Ereignis unterscheidet sich vom CellClick-Ereignis und CellMouseClick-Ereignis, die auftreten, sobald ein Benutzer auf eine beliebige Stelle in einer Zelle klickt.
Die DataGridViewLinkColumn-Klasse stellt mehrere Eigenschaften zum Ändern der Darstellung von Links vor, bei und nach dem Klicken bereit.
Siehe auch
Aufgaben
Gewusst wie: Anzeigen von Bildern in Zellen des DataGridView-Steuerelements in Windows Forms
Gewusst wie: Arbeiten mit Bildspalten im DataGridView-Steuerelement in Windows Forms