DataGridViewRow Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 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

DataGridViewRow()

Initialisiert eine neue Instanz der DataGridViewRow-Klasse ohne Verwendung einer Vorlage.

Eigenschaften

AccessibilityObject	Ruft das der DataGridViewRow.DataGridViewRowAccessibleObject zugewiesene DataGridViewRow 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.
DataBoundItem	Ruft das datengebundene Objekt ab, mit dem die Zeile aufgefüllt wurde.
DataGridView	Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Geerbt von DataGridViewElement)
DefaultCellStyle	Ruft die Standardstile für die Zeile ab, mit denen Zellen in der Zeile gerendert werden, wenn die Stile nicht überschrieben werden.
DefaultHeaderCellType	Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest. (Geerbt von DataGridViewBand)
Displayed	Ruft einen Wert ab, der angibt, ob diese Zeile auf dem Bildschirm angezeigt wird.
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.
HasDefaultCellStyle	Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde. (Geerbt von DataGridViewBand)
HeaderCell	Ruft die Headerzelle der Zeile ab oder legt diese fest.
HeaderCellCore	Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest. (Geerbt von DataGridViewBand)
Height	Ruft die aktuelle Höhe der Zeile ab oder legt diese fest.
Index	Ruft die relative Position des Bands im DataGridView-Steuerelement ab. (Geerbt von DataGridViewBand)
InheritedStyle	Ruft den für die Zeile gültigen Zellstil ab.
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. (Geerbt von DataGridViewBand)
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.
Resizable	Ruft einen Wert ab, der angibt, ob Benutzer die Größe der Zeile ändern können, bzw. dass das Verhalten von der AllowUserToResizeRows-Eigenschaft geerbt wird, oder legt diesen Wert fest.
Selected	Ruft einen Wert ab, der angibt, ob die Zeile ausgewählt ist, oder legt diesen Wert fest.
State	Ruft den aktuellen Zustand der Zeile ab.
Tag	Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest. (Geerbt von DataGridViewBand)
Visible	Ruft einen Wert ab, der angibt, ob die Zeile sichtbar ist, oder legt diesen Wert fest.

Methoden

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Ändert die Rahmenart für den Header einer Eingabezeile gemäß den angegebenen Kriterien.
Clone()	Erstellt eine identische Kopie dieser Zeile.
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 alle vom DataGridViewBand verwendeten Ressourcen frei. (Geerbt von DataGridViewBand)
Dispose(Boolean)	Gibt die von DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Zeichnet ein Fokusrechteck um die angegebenen Begrenzungen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetContextMenuStrip(Int32)	Ruft das Kontextmenü für die Zeile ab.
GetErrorText(Int32)	Ruft den Fehlertext für die Zeile am angegebenen Index ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Berechnet die optimale Höhe der angegebenen Zeile anhand der angegebenen Kriterien.
GetState(Int32)	Gibt einen Wert zurück, der den aktuellen Zustand der Zeile angibt.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDataGridViewChanged()	Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird. (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 Headerzelle 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 für die Zellen der Zeile fest.
ToString()	Ruft eine Klartextzeichenfolge ab, die die Zeile beschreibt.

Gilt für: