DataGrid-Steuerelement für Visual Basic 6.0-Benutzer

Artikel
09/02/2008

Aktualisiert: November 2007

Das DataGrid-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das DataGridView-Steuerelement von Windows Forms ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.

Konzeptionelle Unterschiede

Datenbindung

Das DataGridView-Steuerelement von Visual Basic 2008 benötigt keine datenspezifischen Methoden oder Ereignisse, da alle Aktionen über die Datenquelle ausgeführt werden. Aufgrund dieser Trennung von Darstellung und Datenfunktionalität kann die Datenquelle mit oder ohne Eingaben über die Benutzeroberfläche geändert werden. Darüber hinaus sind mehrere Steuerelemente, die an dieselbe Datenquelle gebunden sind, immer synchron.

Im DataGrid-Steuerelement werden keine Eigenschaften zum Anzeigen und Navigieren (z. B. TabAction, EnterAction, AllowArrows, WrapCellPointer und Scrollable) mehr benötigt. Beispielsweise funktioniert das Datenblatt so, als wäre die Scrollable-Eigenschaft auf True festgelegt: Wenn mehr Daten vorhanden sind, als angezeigt werden können, wird automatisch eine Bildlaufleiste angezeigt. Standardmäßig kann der Benutzer nach dem Vorbild von Excel durch das Datenblatt navigieren: vorwärts mit der TAB-TASTE und rückwärts mit der Tastenkombination UMSCHALT+TAB. Weitere Informationen finden Sie unter Standardbehandlung von Tastatur und Maus im DataGridView-Steuerelement von Windows Forms.

Caption-Eigenschaft

Mithilfe der Caption-Eigenschaft von Visual Basic 6.0 wird eine Titelleiste über dem Raster angezeigt. Wenn die Caption-Eigenschaft leer bleibt, wird keine Titelleiste angezeigt.

Das DataGridView-Steuerelement von Visual Basic 2008 unterstützt Titelleisten nicht. Jedoch können Sie die gleiche Wirkung mithilfe eines Label-Steuerelements erreichen.

Formatieren von Daten

In Visual Basic 6.0 wird die Datenformatierung im DataGrid-Steuerelement unter Verwendung der DataFormat-Eigenschaft und eines StdDataFormat-Objekts durchgeführt. Die Formatierung wird Spalte für Spalte angewendet.

Im DataGridView-Steuerelement von Visual Basic 2008 wird zum Formatieren die Format-Eigenschaft eines DataGridViewCellStyle-Objekts verwendet. Die Formatierung kann auf einzelne Zellen, Spalten oder Zeilen angewendet werden. Weitere Informationen finden Sie unter Datenformatierung im DataGridView-Steuerelement in Windows Forms.

hWndEditor-Eigenschaft

In Visual Basic 6.0 wird die hWndEditor-Eigenschaft verwendet, um den Fensterziehpunkt, der dem Bearbeitungsfenster eines DataGrid-Steuerelements zugewiesen ist, an einen Aufruf der Windows-API zu übergeben.

Das DataGridView-Steuerelement von Visual Basic 2008 verfügt im Bearbeitungsmodus nicht über einen eigenen Fensterziehpunkt. Verwenden Sie ersatzweise die Handle-Eigenschaft des DataGridView-Steuerelements oder eines anderen, eingebetteten Bearbeitungssteuerelements.

MarqueeStyle-Eigenschaft

Mit der MarqueeStyle-Eigenschaft von Visual Basis 6.0 wird die Darstellung einer ausgewählten Zelle oder Zeile gesteuert, z. B. durch Ändern der Rahmenart, Umkehren von Vorder- und Hintergrundfarbe oder Öffnen eines Bearbeitungsfensters.

Es gibt keine direkte Entsprechung für das DataGridView-Steuerelement von Visual Basic 2008. Sie können jedoch die gleiche Wirkung durch eine Kombination der Eigenschaften SelectionMode, CellBorderStyle und Format erzielen. Weitere Informationen finden Sie unter Auswahlmodi im DataGridView-Steuerelement von Windows Forms.

Die Eigenschaften SelLength, SelStart und SelText

Wenn im DataGrid-Steuerelement von Visual Basic 6.0 eine Zelle im Bearbeitungsmodus geöffnet wird, können mit den Eigenschaften SelLength, SelStart und SelText die Anfangsposition der Einfügemarke festgelegt oder Teile des Zelltexts hervorgehoben werden.

Das DataGridView-Steuerelement von Visual Basic 2008 verfügt nicht mehr über diese Eigenschaften. Die Zellen im DataGridView-Steuerelement basieren auf dem TextBox-Steuerelement, d. h., wenn Sie dem EditingControlShowing-Ereignishandler Code hinzufügen, können Sie auf die Eigenschaften SelectionLength, SelectionStart und SelectedText des zugrunde liegenden Steuerelements zugreifen.

Geteilte Ansichten

Das DataGrid-Steuerelement von Visual Basic 6.0 unterstützt die geteilte Ansicht, sodass der Benutzer die gleichen Daten nebeneinander betrachten kann. Die Anzeige einer geteilten Ansicht wird durch das Split-Objekt sowie die Eigenschaften Split, Splits und TabAcrossSplits gesteuert.

Das DataGridView-Steuerelement von Visual Basic 2008 verfügt nicht mehr über diese Eigenschaften. Sie können jeoch die gleiche Wirkung erzielen, indem Sie eines oder mehrere SplitContainer-Steuerelemente und mehrere DataGridView-Steuerelemente verwenden. Die Funktionen der TabAcrossSplits-Eigenschaft können mithilfe der StandardTab-Eigenschaft des DataGridView-Steuerelements dupliziert werden.

Änderungen am Code des DataGrid-Steuerelements

Im folgenden Code werden die Unterschiede zwischen Visual Basic 6.0 und Visual Basic 2008 dadurch veranschaulicht, dass gezeigt wird, wie der Text einer Zelle in der jeweiligen Version hervorgehoben wird, wenn die Zelle in einem DataGridView-Steuerelement von einem Benutzer ausgewählt wurde.

' Visual Basic 6.0
Private Sub DataGrid1_Click()
    DataGrid1.SelStart = 1
    DataGrid1.SelLength = DataGrid1.Text
    MsgBox("The selected text is " & DataGrid1.SelText)
End Sub

' Visual Basic
Private Sub DataGridView1_EditingControlShowing( _
ByVal sender As Object, ByVal e As System.Windows.Forms. _
DataGridViewEditingControlShowingEventArgs) _
Handles DataGridView1.EditingControlShowing
    CType(e.Control, TextBox).SelectionStart = 0
    CType(e.Control, TextBox).SelectionLength = Len(CType(e.Control, _
      TextBox).Text)
    MsgBox("The selected text is " & CType(e.Control, _
      TextBox).SelectedText)
End Sub

Entsprechungen zur DataGrid-Steuerelementeigenschaft, zu Methoden und Ereignissen

In den folgenden Tabellen werden Eigenschaften, Methoden und Ereignisse von Visual Basic 6.0 zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften, Methoden und Ereignisse, die über denselben Namen und dasselbe Verhalten verfügen, werden dabei nicht berücksichtigt. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.

In dieser Tabelle werden Links zu Themen bereitgestellt, in denen Unterschiede im Verhalten erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Themen bereitgestellt, die Alternativen behandeln.

Eigenschaften

Visual Basic 6.0	Visual Basic 2005-Entsprechung
AddNewMode	Neue Implementierung. Die auf Daten bezogenen Operationen werden in der Datenquelle behandelt. Weitere Informationen finden Sie unter Anzeigen von Daten im DataGridView-Steuerelement in Windows Forms.
Align	Dock und Anchor
AllowAddNew	AllowNew (BindingSource)
AllowArrows	Diese Eigenschaft kann nicht mehr angepasst werden, die Pfeilnavigation ist immer zulässig. Weitere Informationen finden Sie unter Standardbehandlung von Tastatur und Maus im DataGridView-Steuerelement von Windows Forms.
AllowDelete	AllowRemove (BindingSource)
AllowRowSizing	AllowUserToResizeRows
AllowUpdate	AllowEdit (BindingSource)
Appearance	Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer.
ApproxCount	Neue Implementierung. Die auf Daten bezogenen Operationen werden in der Datenquelle behandelt. Weitere Informationen finden Sie unter Anzeigen von Daten im DataGridView-Steuerelement in Windows Forms.
BackColor	BackgroundColor Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
Bookmark	Neue Implementierung. Sie können nun auf jedes Element direkt zugreifen.
Caption	Neue Implementierung. Verwenden Sie ein Label-Steuerelement, um die Titelleiste zu simulieren.
Col	SelectedColumns
ColumnHeaders	ColumnHeadersVisible
Container	Parent; erbt von Control.
CurrentCellModified	IsCurrentCellDirty, IsCurrentCellInEditMode
CurrentCellVisible	CurrentCell Hinweis: Wenn die CurrentCell-Eigenschaft auf eine nicht sichtbare Zelle festgelegt ist, wird die betreffende Zelle per Bildlauf im Raster angezeigt (dies entspricht der Festlegung True für CurrentCellVisible).
DataChanged	IsCurrentCellDirty, IsCurrentRowDirty
DataFormats	DataGridViewCellStyle-Objekt. Hinweis: Die Formatierung kann für eine einzelne Zelle, Spalte oder Zeile festgelegt werden.
DefColWidth	WidthDataGridViewColumn-Objekt.
DragIcon DragMode	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
EditActive	IsCurrentCellInEditMode
FirstRow	FirstDisplayedScrollingRowIndex
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Hinweis: Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Schriftartbehandlung für Visual Basic 6.0-Benutzer.
ForeColor	ForeColor Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
HeadFont	DataGridViewCellStyle-Objekt. Hinweis: Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Font-Objekt für Visual Basic 6.0-Benutzer.
HeadLines	Keine direkte Entsprechung. Verwenden Sie die WrapMode-Eigenschaft des DataGridViewCellStyle-Objekts in Kombination mit ColumnHeadersHeight.
Height	Height, erbt von der Control-Klasse. Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
HelpContextID	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
hWnd	Handle
hWndEditor	Neue Implementierung. Verwenden Sie Handle.
Index	Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer.
Left	Left, erbt von der Control-Klasse. Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
LeftCol	FirstDisplayedScrollingColumnIndex
MarqueeStyle	Keine direkte Entsprechung. Verwenden Sie die Eigenschaften SelectionMode, CellBorderStyle und Format.
RecordSelectors	RowHeadersVisible
Row	SelectedRows
RowDividerStyle	Die Eigenschaften GridColor, CellBorderStyle, RowHeadersBorderStyle, ColumnHeadersBorderStyle.
RowHeight	Height
SelBookmarks	Neue Implementierung. Sie können nun auf jedes Element direkt zugreifen.
SelEndCol SelStartCol	SelectedCells, SelectedColumns
SelLength	Keine direkte Entsprechung. Verwenden Sie die SelectionLength-Eigenschaft im EditingControlShowing-Ereignishandler.
SelStart	Keine direkte Entsprechung. Verwenden Sie die SelectionStart-Eigenschaft im EditingControlShowing-Ereignishandler.
SelText	Keine direkte Entsprechung. Verwenden Sie die SelectedText-Eigenschaft im EditingControlShowing-Ereignishandler.
Split Splits TabAcrossSplits	Neue Implementierung. Geteilte Ansichten werden nicht direkt unterstützt. Verwenden Sie ersatzweise ein SplitContainer-Steuerelement.
TabAction	StandardTab
Tag	Neue Implementierung.
Text	CurrentCell.Value Hinweis: Die Value-Eigenschaft gibt ein Object zurück. Mit CStr oder ToString können Sie dieses in einen String konvertieren.
ToolTipText	ToolTip-Komponente Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer.
Top	Top Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
VisibleCols	DisplayedColumnCount-Methode. Hinweis: In Visual Basic 6.0 werden auch die nur teilweise sichtbaren Spalten bei der Zählung berücksichtigt. Die DisplayedColumnCount-Methode legt mithilfe eines booleschen includePartialColumns-Parameters fest, ob teilweise sichtbare Spalten mitgezählt werden.
VisibleRows	DisplayedRowCount-Methode. Hinweis: In Visual Basic 6.0 werden auch die nur teilweise sichtbaren Zeilen bei der Zählung berücksichtigt. Die DisplayedRowCount-Methode legt mithilfe eines booleschen includePartialRows-Parameters fest, ob teilweise sichtbare Zeilen mitgezählt werden.
WhatsThisHelpID	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
Width	Width, erbt von der Control-Klasse. Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
WrapCellPointer	Diese Eigenschaft kann nicht mehr angepasst werden; das Standardverhalten lautet WrapCellPointer = True.

Methoden

Visual Basic 6.0	Visual Basic 2005-Entsprechung
CaptureImage	Neue Implementierung. Der Inhalt eines DataGridView-Steuerelements kann nicht mehr in einem PictureBox-Steuerelement aufgezeichnet werden.
ClearFields	Neue Implementierung. Die Spaltenformatierung wird beim erneuten Binden automatisch vorgenommen.
ClearSelCols	ClearSelection
ColContaining	IndexOf (DataGridViewColumnCollection)
Drag	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
GetBookmark	Neue Implementierung. Lesezeichen werden nicht mehr unterstützt.
HoldFields	Neue Implementierung. Die Spaltenformatierung wird bei einer erneuten Bindung beibehalten.
Move	SetBounds, erbt von der Control-Klasse. Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
Rebind	ResetBindings, erbt von der Control-Klasse.
RowBookmark	Neue Implementierung. Lesezeichen werden nicht mehr unterstützt.
RowContaining	IndexOf (DataGridViewColumnCollection)
RowTop	GetContentBounds (DataGridViewCell)
Scroll	Neue Implementierungsmethode. Verwenden Sie die CurrentCell-Eigenschaft.
SetFocus	Focus
ShowWhatsThis	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
SplitContaining	Neue Implementierung. Geteilte Ansichten werden nicht direkt unterstützt. Verwenden Sie ersatzweise ein SplitContainer-Steuerelement.
ZOrder	BringToFront()-Funktion oder SendToBack()-Funktion

Ereignisse

Visual Basic 6.0	Visual Basic 2005-Entsprechung
AfterColEdit	CellEndEdit
AfterColUpdate AfterDelete	Neue Implementierung. Die auf Daten bezogenen Operationen werden in der Datenquelle behandelt. Weitere Informationen finden Sie unter Anzeigen von Daten im DataGridView-Steuerelement in Windows Forms.
AfterUpdate	RowsAdded
BeforeColEdit	CellBeginEdit
BeforeColUpdate BeforeDelete BeforeInsert BeforeUpdate	Neue Implementierung. Die auf Daten bezogenen Operationen werden in der Datenquelle behandelt. Weitere Informationen finden Sie unter Anzeigen von Daten im DataGridView-Steuerelement in Windows Forms.
ButtonClick	Click (Button-Steuerelement)
Change	TextChanged Hinweis: Das Verhalten des TextChanged-Ereignisses weicht geringfügig ab. Weitere Informationen finden Sie unter Change-Ereignis des ComboBox-Steuerelements für Visual Basic 6.0-Benutzer.
Click	SelectedIndexChanged
ColEdit	CellBeginEdit
ColResize	ColumnWidthChanged
DblClick	CellMouseDoubleClick
DragDrop DragOver	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Error	DataError
HeadClick	ColumnHeaderMouseClick
MouseDown	CellMouseDown
MouseMove	CellMouseMove
MouseUp	CellMouseUp
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
OnAddNew	RowsAdded
RowColChange	CurrentCellChanged
RowResize	RowHeightChanged
SelChange	SelectionChanged
SplitChange	Neue Implementierung. Geteilte Ansichten werden nicht direkt unterstützt. Verwenden Sie ersatzweise ein SplitContainer-Steuerelement.
Validate	Validating

Hinweise zum Durchführen des Updates

Wenn Sie ein Visual Basic 6.0-Projekt auf Visual Basic 2008 aktualisieren, wird das Change-Ereignis des DataGrid-Steuerelements dem TextChanged-Ereignis des DataGridView-Steuerelements von Visual Basic 2008 zugeordnet. Das Verhalten des TextChanged-Ereignisses weicht von dem des Change-Ereignisses ab. Dieser Unterschied kann zu unerwünschten Ergebnissen im Code führen.

Für auf datenspezifische Methoden oder Ereignisse bezogenen Code erfolgt kein Update. Bestimmten Codeabschnitten werden Warnkommentare hinzugefügt, und vor dem Kompilieren der Anwendung müssen diese Codeabschnitte entfernt oder geändert werden.

Siehe auch