Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataGridViewRow-Klasse
Stellt eine Zeile in einem DataGridView-Steuerelement dar.
System.Windows.Forms.DataGridViewElement
System.Windows.Forms.DataGridViewBand
System.Windows.Forms.DataGridViewRow
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Der DataGridViewRow-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
DataGridViewRow | Initialisiert eine neue Instanz der DataGridViewRow-Klasse ohne Verwendung einer Vorlage. |
| Name | Beschreibung | |
|---|---|---|
|
AccessibilityObject | Ruft das der DataGridViewRow zugewiesene DataGridViewRow.DataGridViewRowAccessibleObject ab. |
|
|
Cells | Ruft die Auflistung von Zellen ab, mit denen die Zeile aufgefüllt ist. |
|
|
ContextMenuStrip | Ruft das Kontextmenü für die Zeile ab oder legt dieses fest. (Überschreibt DataGridViewBand.ContextMenuStrip.) |
|
|
DataBoundItem | Ruft das datengebundene Objekt ab, mit dem die Zeile aufgefüllt wurde. |
|
|
DataGridView | Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Von DataGridViewElement geerbt.) |
|
|
DefaultCellStyle | Ruft die Standardstile für die Zeile ab, mit denen Zellen in der Zeile gerendert werden, wenn die Stile nicht überschrieben werden. (Überschreibt DataGridViewBand.DefaultCellStyle.) |
|
|
DefaultHeaderCellType | Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest. (Von DataGridViewBand geerbt.) |
|
|
Displayed | Ruft einen Wert ab, der angibt, ob diese Zeile auf dem Bildschirm angezeigt wird. (Überschreibt DataGridViewBand.Displayed.) |
|
|
DividerHeight | Ruft die Höhe des Zeilenunterteilers in Pixel ab oder legt diese fest. |
|
|
ErrorText | Ruft den Fehlermeldungstext für Fehler auf Zeilenebene ab oder legt diesen fest. |
|
|
Frozen | Ruft einen Wert ab, der angibt, ob die Zeile fixiert ist, oder legt diesen Wert fest. (Überschreibt DataGridViewBand.Frozen.) |
|
|
HasDefaultCellStyle | Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde. (Von DataGridViewBand geerbt.) |
|
|
HeaderCell | Ruft die Headerzelle der Zeile ab oder legt diese fest. |
|
HeaderCellCore | Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest. (Von DataGridViewBand geerbt.) |
|
|
Height | Ruft die aktuelle Höhe der Zeile ab oder legt diese fest. |
|
|
Index | Ruft die relative Position des Bands im DataGridView-Steuerelement ab. (Von DataGridViewBand geerbt.) |
|
|
InheritedStyle | Ruft den für die Zeile gültigen Zellstil ab. (Überschreibt DataGridViewBand.InheritedStyle.) |
|
|
IsNewRow | Ruft einen Wert ab, der angibt, ob die Zeile die Zeile für neue Datensätze darstellt. |
|
|
IsRow | Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Von DataGridViewBand geerbt.) |
|
|
MinimumHeight | Ruft die Mindesthöhe der Zeile ab oder legt diese fest. |
|
|
ReadOnly | Ruft einen Wert ab, der angibt, ob die Zeile schreibgeschützt ist, oder legt diesen Wert fest. (Überschreibt DataGridViewBand.ReadOnly.) |
|
|
Resizable | Ruft einen Wert ab, der angibt, ob Benutzer die Größe der Zeile ändern können, bzw. dass das Verhalten von der DataGridView.AllowUserToResizeRows-Eigenschaft geerbt wird, oder legt diesen Wert fest. (Überschreibt DataGridViewBand.Resizable.) |
|
|
Selected | Ruft einen Wert ab, der angibt, ob die Zeile ausgewählt ist, oder legt diesen Wert fest. (Überschreibt DataGridViewBand.Selected.) |
|
|
State | Ruft den aktuellen Zustand der Zeile ab. (Überschreibt DataGridViewElement.State.) |
|
|
Tag | Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest. (Von DataGridViewBand geerbt.) |
|
|
Visible | Ruft einen Wert ab, der angibt, ob die Zeile sichtbar ist, oder legt diesen Wert fest. (Überschreibt DataGridViewBand.Visible.) |
| Name | Beschreibung | |
|---|---|---|
|
|
AdjustRowHeaderBorderStyle | Ändert die Rahmenart für den Header einer Eingabezeile gemäß den angegebenen Kriterien. |
|
|
Clone | Erstellt eine identische Kopie dieser Zeile. (Überschreibt DataGridViewBand.Clone().) |
|
CreateAccessibilityInstance | Erstellt ein neues barrierefreies Objekt für die DataGridViewRow. |
|
|
CreateCells(DataGridView) | Löscht die vorhandenen Zellen und legt die entsprechende Vorlage gemäß der bereitgestellten DataGridView-Vorlage fest. |
|
|
CreateCells(DataGridView, Object[]) | Löscht die vorhandenen Zellen und legt ihre Vorlage sowie ihre Werte fest. |
|
|
CreateCellsInstance | Erstellt anhand dieser Zeile eine neue Auflistung von Zellen. |
|
|
Dispose() | Gibt sämtliche von DataGridViewBand verwendeten Ressourcen frei. (Von DataGridViewBand geerbt.) |
|
|
Dispose(Boolean) | Gibt die vom DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von DataGridViewBand geerbt.) |
|
|
DrawFocus | Zeichnet ein Fokusrechteck um die angegebenen Begrenzungen. |
|
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
|
Finalize | Gibt die dem Band zugeordneten Ressourcen frei. (Von DataGridViewBand geerbt.) |
|
|
GetContextMenuStrip | Ruft das Kontextmenü für die Zeile ab. |
|
|
GetErrorText | Ruft den Fehlertext für die Zeile am angegebenen Index ab. |
|
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
|
GetPreferredHeight | Berechnet die optimale Höhe der angegebenen Zeile anhand der angegebenen Kriterien. |
|
|
GetState | Gibt einen Wert zurück, der den aktuellen Zustand der Zeile angibt. |
|
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
|
OnDataGridViewChanged | Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird. (Von DataGridViewBand geerbt.) |
|
|
Paint | Zeichnet die aktuelle Zeile. |
|
|
PaintCells | Zeichnet die Zellen in der aktuellen Zeile. |
|
|
PaintHeader | Zeichnet die Headerzelle der aktuellen Zeile. |
|
|
RaiseCellClick | Löst das DataGridView.CellClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
RaiseCellContentClick | Löst das DataGridView.CellContentClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
RaiseCellContentDoubleClick | Löst das DataGridView.CellContentDoubleClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
RaiseCellValueChanged | Löst das DataGridView.CellValueChanged-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
RaiseDataError | Löst das DataGridView.DataError-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
RaiseMouseWheel | Löst das Control.MouseWheel-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
|
SetValues | Legt die Werte für die Zellen der Zeile fest. |
|
|
ToString | Ruft eine Klartextzeichenfolge ab, die die Zeile beschreibt. (Überschreibt DataGridViewBand.ToString().) |
Die DataGridViewRow-Klasse stellt eine Zeile in einem DataGridView-Steuerelement dar. Sie können Zeilen durch die Rows-Auflistung und die SelectedRows-Auflistung des Steuerelements abrufen.
Im Gegensatz zu einer DataGridViewColumn enthält eine DataGridViewRow physisch eine Auflistung aller Zellen in dieser Zeile. Sie können auf diese Auflistung über die Cells-Eigenschaft zugreifen.
Mit der DataGridViewRow-Klasse wird auf die einzelnen Zellelemente zugegriffen und die Darstellung sowie das Verhalten der Zeilenbenutzeroberfläche angepasst, z. B. die Höhe und der Zellstil. In der Regel besitzen alle Zeilen bzw. die meisten Zeilen im Steuerelement dieselben Merkmale. Wenn Sie die Zellstile für alle Zeilen im Steuerelement festlegen möchten, legen Sie die Eigenschaften des von der DataGridView.RowsDefaultCellStyle-Eigenschaft zurückgegebenen Objekts fest. Verwenden Sie zum Festlegen der Stile für abwechselnde Zeilen die DataGridView.AlternatingRowsDefaultCellStyle-Eigenschaft. Weitere Informationen zu Zellstilen finden Sie unter Zellstile im DataGridView-Steuerelement in Windows Forms. Mithilfe der DataGridView.RowTemplate-Eigenschaft können Sie zudem eine Zeile definieren, die als Grundlage für alle Zeilen verwendet wird, die dem Steuerelement hinzugefügt werden.
Das DataGridView-Steuerelement gibt DataGridViewRow-Objekte möglichst immer über mehrere Datenzeilen hinweg frei, um Leistungseinbußen zu verhindern. Wenn Sie nicht mit großen Datenmengen arbeiten und keine Leistungsprobleme vorliegen, können Sie die Freigabe von Zeilen normalerweise ignorieren. Eine freigegebene Zeile wird durch einen Index-Eigenschaftswert von -1 angegeben. Einige Member der DataGridViewRow-Klasse können nicht mit freigegebenen Zeilen verwendet werden. Sie können jedoch die Freigabe einer Zeile aufheben, indem Sie mit der DataGridViewRowCollection.Item-Eigenschaft auf sie zugreifen. Die Freigabe von Zeilen kann auch auf andere Art und Weise aufgehoben werden. Verwenden Sie die DataGridViewRowCollection.SharedRow-Methode, um auf eine Zeile zuzugreifen, ohne die Freigabe aufzuheben. Wenn Sie mit großen Datenmengen arbeiten, sollten Sie wissen, wie Zeilen freigegeben werden und Freigaben aufgehoben werden, um auf diese Weise Leistungseinbußen zu verhindern. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.
Hinweise zur Vererbung
Wenn Sie aus DataGridViewRow ableiten und der abgeleiteten Klasse neue Eigenschaften hinzufügen, muss die Clone-Methode überschrieben werden, damit die neuen Eigenschaften während der Klonvorgänge kopiert werden. Sie sollten auch die Clone-Methode der Basisklasse aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.
Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Dieses Beispiel ist Teil eines umfangreicheren Beispiels in Gewusst wie: Bearbeiten von Zeilen im DataGridView-Steuerelement in Windows Forms.
// Set row labels. private void Button6_Click(object sender, System.EventArgs e) { int rowNumber = 1; foreach (DataGridViewRow row in dataGridView.Rows) { if (row.IsNewRow) continue; row.HeaderCell.Value = "Row " + rowNumber; rowNumber = rowNumber + 1; } dataGridView.AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders); }
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.
