DataGridViewRow Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewRow.cs

Stellt eine Zeile in einem DataGridView Steuerelement dar.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand

Public Class DataGridViewRow
Inherits DataGridViewBand

Vererbung

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Attribute

TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Manipulate Rows in the Windows Forms DataGridView Control verfügbar ist.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}

// 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);
}

' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

Hinweise

Die DataGridViewRow Klasse stellt eine Zeile in einem DataGridView Steuerelement dar. Sie können Zeilen über die Rows Auflistungen SelectedRows des Steuerelements abrufen.

Im Gegensatz zu einem DataGridViewColumn, eine DataGridViewRow physisch enthält eine Auflistung aller Zellen in dieser Zeile. Sie können über die Cells Eigenschaft auf diese Sammlung zugreifen.

Die DataGridViewRow Klasse wird verwendet, um auf die einzelnen Zellelemente zuzugreifen, sowie um das Erscheinungsbild und Verhalten der Benutzeroberfläche der Zeile anzupassen, z. B. Höhe und Zellenformatvorlage. In der Regel möchten Sie, dass alle Zeilen oder die meisten Zeilen im Steuerelement dieselben Merkmale aufweisen. Wenn Sie Zellformatvorlagen für alle Zeilen im Steuerelement festlegen möchten, legen Sie die Eigenschaften des objekts fest, das von der DataGridView.RowsDefaultCellStyle Eigenschaft zurückgegeben wird. Verwenden Sie die DataGridView.AlternatingRowsDefaultCellStyle Eigenschaft, um Formatvorlagen für abwechselnde Zeilen festzulegen. Weitere Informationen zu Zellenformatvorlagen finden Sie unter "Zellenformatvorlagen" im Windows Forms DataGridView-Steuerelement. Sie können die DataGridView.RowTemplate Eigenschaft auch verwenden, um eine Zeile zu definieren, die als Grundlage für alle Zeilen verwendet wird, die dem Steuerelement hinzugefügt werden.

Das DataGridView Steuerelement teilt DataGridViewRow Objekte nach Möglichkeit über mehrere Datenzeilen hinweg, um Leistungseinbußen zu vermeiden. Wenn Sie nicht mit großen Datenmengen arbeiten und Leistungsprobleme auftreten, können Sie die Zeilenfreigabe in der Regel ignorieren. Eine freigegebene Zeile wird durch einen Index Eigenschaftswert von -1 angegeben. Einige Member der DataGridViewRow Klasse können nicht für freigegebene Zeilen verwendet werden, aber Sie können die Freigabe einer Zeile aufheben, indem Sie über die DataGridViewRowCollection.Item[] Eigenschaft darauf zugreifen. Zeilen können auch auf andere Weise entharrt werden. Um auf eine Zeile zuzugreifen, ohne die Freigabe aufzuheben, verwenden Sie die DataGridViewRowCollection.SharedRow Methode. Wenn Sie mit großen Datenmengen arbeiten, sollten Sie wissen, wie Zeilen freigegeben und nicht freigegeben werden, um Leistungseinbußen zu vermeiden. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.

Hinweise für Vererber

Wenn Sie von der abgeleiteten Klasse abgeleitete Eigenschaften ableiten DataGridViewRow und neue Eigenschaften hinzufügen, müssen Sie die Clone() Methode überschreiben, um die neuen Eigenschaften während Klonvorgängen zu kopieren. Sie sollten auch die Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Konstruktoren

Name	Beschreibung
DataGridViewRow()	Initialisiert eine neue Instanz der DataGridViewRow Klasse, ohne eine Vorlage zu verwenden.

Eigenschaften

Name	Beschreibung
AccessibilityObject	Ruft die DataGridViewRow.DataGridViewRowAccessibleObject zugewiesene der DataGridViewRow.
Cells	Ruft die Auflistung der Zellen ab, die die Zeile auffüllen.
ContextMenuStrip	Ruft ab oder legt das Kontextmenü für die Zeile fest.
DataBoundItem	Ruft das datengebundene Objekt ab, das die Zeile aufgefüllt hat.
DataGridView	Ruft das DataGridView diesem Element zugeordnete Steuerelement ab. (Geerbt von DataGridViewElement)
DefaultCellStyle	Ruft die Standardformatvorlagen für die Zeile ab, die zum Rendern von Zellen in der Zeile verwendet werden, es sei denn, die Formatvorlagen werden überschrieben.
DefaultHeaderCellType	Dient zum Abrufen oder Festlegen des Laufzeittyps der Standardkopfzeilenzelle. (Geerbt von DataGridViewBand)
Displayed	Ruft einen Wert ab, der angibt, ob diese Zeile auf dem Bildschirm angezeigt wird.
DividerHeight	Ruft die Höhe der Zeilentrennlinie in Pixel ab oder legt sie fest.
ErrorText	Dient zum Abrufen oder Festlegen des Fehlermeldungstexts für Fehler auf Zeilenebene.
Frozen	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeile fixiert ist.
HasDefaultCellStyle	Ruft einen Wert ab, der angibt, ob die DefaultCellStyle Eigenschaft festgelegt wurde. (Geerbt von DataGridViewBand)
HeaderCell	Ruft die Kopfzeilenzelle der Zeile ab oder legt sie fest.
HeaderCellCore	Ruft die Kopfzeilenzelle der DataGridViewBand. (Geerbt von DataGridViewBand)
Height	Ruft die aktuelle Höhe der Zeile ab oder legt sie fest.
Index	Ruft die relative Position des Bereichs innerhalb des DataGridView Steuerelements ab. (Geerbt von DataGridViewBand)
InheritedStyle	Ruft die Zellenformatvorlage für die Zeile ab.
IsNewRow	Ruft einen Wert ab, der angibt, ob die Zeile die Zeile für neue Datensätze ist.
IsRow	Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Geerbt von DataGridViewBand)
MinimumHeight	Ruft die Mindesthöhe der Zeile ab oder legt sie fest.
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeile schreibgeschützt ist.
Resizable	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Benutzer die Größe der Zeile ändern oder angeben können, dass das Verhalten von der AllowUserToResizeRows Eigenschaft geerbt wird.
Selected	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeile ausgewählt ist.
State	Ruft den aktuellen Status der Zeile ab.
Tag	Dient zum Abrufen oder Festlegen des Objekts, das Daten enthält, die dem Band zugeordnet werden sollen. (Geerbt von DataGridViewBand)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeile sichtbar ist.

Methoden

Name	Beschreibung
AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Ändert eine Rahmenart für die Eingabezeilenkopfzeile gemäß den angegebenen Kriterien.
Clone()	Erstellt eine genaue Kopie dieser Zeile.
CreateAccessibilityInstance()	Erstellt ein neues barrierefreies Objekt für das DataGridViewRow.
CreateCells(DataGridView, Object[])	Löscht die vorhandenen Zellen und legt deren Vorlage und Werte fest.
CreateCells(DataGridView)	Löscht die vorhandenen Zellen und legt ihre Vorlage entsprechend der angegebenen DataGridView Vorlage fest.
CreateCellsInstance()	Erstellt eine neue Auflistung von Zellen basierend auf dieser Zeile.
Dispose()	Veröffentlicht alle ressourcen, die von der DataGridViewBand. (Geerbt von DataGridViewBand)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den DataGridViewBand verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Zeichnet ein Fokusrechteck um die angegebenen Grenzen.
GetContextMenuStrip(Int32)	Ruft das Kontextmenü für die Zeile ab.
GetErrorText(Int32)	Ruft den Fehlertext für die Zeile am angegebenen Index ab.
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Berechnet die ideale Höhe der angegebenen Zeile basierend auf den angegebenen Kriterien.
GetState(Int32)	Gibt einen Wert zurück, der den aktuellen Status der Zeile angibt.
OnDataGridViewChanged()	Wird aufgerufen, wenn das Band einem anderen DataGridViewzugeordnet ist. (Geerbt von DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	Zeichnet die aktuelle Zeile.
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Zeichnet die Zellen in der aktuellen Zeile.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Zeichnet die Kopfzeilenzelle der aktuellen Zeile.
RaiseCellClick(DataGridViewCellEventArgs)	Löst das CellClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Löst das CellContentClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Löst das CellContentDoubleClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Löst das CellValueChanged-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Löst das DataError-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Löst das MouseWheel-Ereignis aus. (Geerbt von DataGridViewElement)
SetValues(Object[])	Legt die Werte der Zellen der Zeile fest.
ToString()	Ruft eine lesbare Zeichenfolge ab, die die Zeile beschreibt.

Weitere Informationen

• DataGridView
• DataGridViewColumn
• Clone()
• Bewährte Methoden für die Skalierung des Windows Forms DataGridView-Steuerelements
• Zellenformatvorlagen im Windows Forms DataGridView-Steuerelement