DataGridViewRow Klasse

Definition

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 unter Vorgehensweise: Bearbeiten von Zeilen im Windows Forms DataGridView-Steuerelement 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 und SelectedRows des -Steuerelements abrufen.

Im Gegensatz zu enthält DataGridViewColumnein DataGridViewRow physisch 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 Aussehen und Verhalten der Zeilenbenutzeroberfläche (UI) anzupassen, z. B. Höhe und Zellenformat. In der Regel möchten Sie, dass alle Zeilen oder die meisten Zeilen im Steuerelement dieselben Merkmale aufweisen. Um Zellenformatvorlagen für alle Zeilen im Steuerelement festzulegen, 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 Zellenstilen finden Sie unter Zellenstile im DataGridView-Steuerelement in Windows Forms. 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 verwendet DataGridViewRow nach Möglichkeit Objekte ü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 den Index Eigenschaftswert -1 angegeben. Einige Member der DataGridViewRow -Klasse können nicht mit freigegebenen 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 aufgehoben werden. Verwenden Sie die -Methode, um auf eine Zeile zuzugreifen, ohne die DataGridViewRowCollection.SharedRow Freigabe aufzuheben. Wenn Sie mit großen Datenmengen arbeiten, sollten Sie beachten, wie Zeilen freigegeben und nicht freigegeben werden, um Leistungseinbußen zu vermeiden. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Hinweise für Vererber

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

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• DataGridView
• DataGridViewColumn
• Clone()
• Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms
• Zellstile im DataGridView-Steuerelement in Windows Forms