DataGridViewRow Klasse

Definition

Stellt eine Zeile in einem DataGridView-Steuerelement dar.Represents a row in a DataGridView control.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand
type DataGridViewRow = class
    inherit DataGridViewBand
Public Class DataGridViewRow
Inherits DataGridViewBand
Vererbung
Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht.The following code example illustrates the use of this type. Dieses Beispiel ist Teil eines größeren Beispiels, das in gewusst wie: Bearbeiten Sie Zeilen im Windows Forms DataGridView-Steuerelement.This example is part of a larger example available in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// 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.The DataGridViewRow class represents a row in a DataGridView control. Sie können Zeilen über die Rows und SelectedRows Auflistungen des-Steuer Elements abrufen.You can retrieve rows through the Rows and SelectedRows collections of the control.

Anders als bei einer DataGridViewColumnenthält eine DataGridViewRow physisch eine Auflistung aller Zellen in dieser Zeile.Unlike a DataGridViewColumn, a DataGridViewRow physically contains a collection of all of the cells in that row. Sie können über die Cells-Eigenschaft auf diese Sammlung zugreifen.You can access this collection through the Cells property.

Die DataGridViewRow-Klasse wird verwendet, um auf die einzelnen Zellen Elemente zuzugreifen, und um das Aussehen und Verhalten der Zeilen Benutzeroberfläche (UI) anzupassen, wie z. b. Höhe und Zellen Stil.The DataGridViewRow class is used to access the individual cell elements, as well as to adjust the appearance and behavior of the row user interface (UI), such as height and cell style. In der Regel möchten Sie, dass alle Zeilen oder die meisten Zeilen im-Steuerelement die gleichen Merkmale aufweisen.Typically, you will want all rows or most rows in the control to share the same characteristics. Legen Sie die Eigenschaften des-Objekts fest, das von der DataGridView.RowsDefaultCellStyle-Eigenschaft zurückgegeben wird, um Zellen Stile für alle Zeilen im-Steuerelement festzulegen.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Um Stile für abwechselnde Zeilen festzulegen, verwenden Sie die DataGridView.AlternatingRowsDefaultCellStyle-Eigenschaft.To set styles for alternating rows, use the DataGridView.AlternatingRowsDefaultCellStyle property. Weitere Informationen zu Zell Formaten finden Sie unter Zellen Stile im Windows Forms DataGridView-SteuerElement.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. Sie können auch die DataGridView.RowTemplate-Eigenschaft verwenden, um eine Zeile zu definieren, die als Grundlage für alle Zeilen verwendet wird, die dem Steuerelement hinzugefügt werden.You can also use the DataGridView.RowTemplate property to define a row that will be used as a basis for all rows added to the control.

Das DataGridView Steuerelement verwendet DataGridViewRow Objekte in mehreren Daten Zeilen, wann immer dies möglich ist, um Leistungseinbußen zu vermeiden.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. Wenn Sie nicht mit großen Datenmengen arbeiten und Leistungsprobleme auftreten, können Sie die Zeilen Freigabe in der Regel ignorieren.Unless you are working with large amounts of data and experiencing performance issues, you can typically ignore row sharing. Eine freigegebene Zeile wird durch den Index-Eigenschafts Wert-1 angegeben.A shared row is indicated by an Index property value of -1. 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[Int32]-Eigenschaft darauf zugreifen.Some members of the DataGridViewRow class cannot be used with shared rows, but you can unshare a row by accessing it through the DataGridViewRowCollection.Item[Int32] property. Zeilen können auch auf andere Weise freigegeben werden.Rows can also become unshared in other ways. Verwenden Sie die DataGridViewRowCollection.SharedRow-Methode, um auf eine Zeile zuzugreifen, ohne die Freigabe freizugeben.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. Beim Arbeiten mit großen Datenmengen sollten Sie sich darüber im klaren sein, wie Zeilen freigegeben und freigegeben werden, um Leistungseinbußen zu vermeiden.When working with large amounts of data, you should be aware of how rows are shared and unshared to avoid performance penalties. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Hinweise für Vererber

Wenn Sie von DataGridViewRow ableiten und der abgeleiteten Klasse neue Eigenschaften hinzufügen, stellen Sie sicher, dass Sie die Clone()-Methode überschreiben, um die neuen Eigenschaften während des Klon Vorgangs zu kopieren.When you derive from DataGridViewRow and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Sie sollten auch die Clone()-Methode der Basisklasse aufzurufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Konstruktoren

DataGridViewRow()

Initialisiert eine neue Instanz der DataGridViewRow-Klasse ohne Verwendung einer Vorlage.Initializes a new instance of the DataGridViewRow class without using a template.

Eigenschaften

AccessibilityObject

Ruft das der DataGridViewRow.DataGridViewRowAccessibleObject zugewiesene DataGridViewRow ab.Gets the DataGridViewRow.DataGridViewRowAccessibleObject assigned to the DataGridViewRow.

Cells

Ruft die Auflistung von Zellen ab, mit denen die Zeile aufgefüllt ist.Gets the collection of cells that populate the row.

ContextMenuStrip

Ruft das Kontextmenü für die Zeile ab oder legt dieses fest.Gets or sets the shortcut menu for the row.

DataBoundItem

Ruft das datengebundene Objekt ab, mit dem die Zeile aufgefüllt wurde.Gets the data-bound object that populated the row.

DataGridView

Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab.Gets the DataGridView control associated with this element.

(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.Gets or sets the default styles for the row, which are used to render cells in the row unless the styles are overridden.

DefaultHeaderCellType

Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest.Gets or sets the run-time type of the default header cell.

(Geerbt von DataGridViewBand)
Displayed

Ruft einen Wert ab, der angibt, ob diese Zeile auf dem Bildschirm angezeigt wird.Gets a value indicating whether this row is displayed on the screen.

DividerHeight

Ruft die Höhe des Zeilenunterteilers in Pixel ab oder legt diese fest.Gets or sets the height, in pixels, of the row divider.

ErrorText

Ruft den Fehlermeldungstext für Fehler auf Zeilenebene ab oder legt diesen fest.Gets or sets the error message text for row-level errors.

Frozen

Ruft einen Wert ab, der angibt, ob die Zeile fixiert ist, oder legt diesen Wert fest.Gets or sets a value indicating whether the row is frozen.

HasDefaultCellStyle

Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde.Gets a value indicating whether the DefaultCellStyle property has been set.

(Geerbt von DataGridViewBand)
HeaderCell

Ruft die Headerzelle der Zeile ab oder legt diese fest.Gets or sets the row's header cell.

HeaderCellCore

Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest.Gets or sets the header cell of the DataGridViewBand.

(Geerbt von DataGridViewBand)
Height

Ruft die aktuelle Höhe der Zeile ab oder legt diese fest.Gets or sets the current height of the row.

Index

Ruft die relative Position des Bands im DataGridView-Steuerelement ab.Gets the relative position of the band within the DataGridView control.

(Geerbt von DataGridViewBand)
InheritedStyle

Ruft den für die Zeile gültigen Zellstil ab.Gets the cell style in effect for the row.

IsNewRow

Ruft einen Wert ab, der angibt, ob die Zeile die Zeile für neue Datensätze darstellt.Gets a value indicating whether the row is the row for new records.

IsRow

Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt.Gets a value indicating whether the band represents a row.

(Geerbt von DataGridViewBand)
MinimumHeight

Ruft die Mindesthöhe der Zeile ab oder legt diese fest.Gets or sets the minimum height of the row.

ReadOnly

Ruft einen Wert ab, der angibt, ob die Zeile schreibgeschützt ist, oder legt diesen Wert fest.Gets or sets a value indicating whether the row is read-only.

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.Gets or sets a value indicating whether users can resize the row or indicating that the behavior is inherited from the AllowUserToResizeRows property.

Selected

Ruft einen Wert ab, der angibt, ob die Zeile ausgewählt ist, oder legt diesen Wert fest.Gets or sets a value indicating whether the row is selected.

State

Ruft den aktuellen Zustand der Zeile ab.Gets the current state of the row.

Tag

Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest.Gets or sets the object that contains data to associate with the band.

(Geerbt von DataGridViewBand)
Visible

Ruft einen Wert ab, der angibt, ob die Zeile sichtbar ist, oder legt diesen Wert fest.Gets or sets a value indicating whether the row is visible.

Methoden

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Ändert die Rahmenart für den Header einer Eingabezeile gemäß den angegebenen Kriterien.Modifies an input row header border style according to the specified criteria.

Clone()

Erstellt eine identische Kopie dieser Zeile.Creates an exact copy of this row.

CreateAccessibilityInstance()

Erstellt ein neues barrierefreies Objekt für die DataGridViewRow.Creates a new accessible object for the DataGridViewRow.

CreateCells(DataGridView)

Löscht die vorhandenen Zellen und legt die entsprechende Vorlage gemäß der bereitgestellten DataGridView-Vorlage fest.Clears the existing cells and sets their template according to the supplied DataGridView template.

CreateCells(DataGridView, Object[])

Löscht die vorhandenen Zellen und legt ihre Vorlage sowie ihre Werte fest.Clears the existing cells and sets their template and values.

CreateCellsInstance()

Erstellt anhand dieser Zeile eine neue Auflistung von Zellen.Constructs a new collection of cells based on this row.

Dispose()

Gibt alle vom DataGridViewBand verwendeten Ressourcen frei.Releases all resources used by the DataGridViewBand.

(Geerbt von DataGridViewBand)
Dispose(Boolean)

Gibt die von DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Geerbt von DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Zeichnet ein Fokusrechteck um die angegebenen Begrenzungen.Draws a focus rectangle around the specified bounds.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetContextMenuStrip(Int32)

Ruft das Kontextmenü für die Zeile ab.Gets the shortcut menu for the row.

GetErrorText(Int32)

Ruft den Fehlertext für die Zeile am angegebenen Index ab.Gets the error text for the row at the specified index.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Berechnet die optimale Höhe der angegebenen Zeile anhand der angegebenen Kriterien.Calculates the ideal height of the specified row based on the specified criteria.

GetState(Int32)

Gibt einen Wert zurück, der den aktuellen Zustand der Zeile angibt.Returns a value indicating the current state of the row.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDataGridViewChanged()

Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird.Called when the band is associated with a different DataGridView.

(Geerbt von DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Zeichnet die aktuelle Zeile.Paints the current row.

PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Zeichnet die Zellen in der aktuellen Zeile.Paints the cells in the current row.

PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Zeichnet die Headerzelle der aktuellen Zeile.Paints the header cell of the current row.

RaiseCellClick(DataGridViewCellEventArgs)

Löst das CellClick-Ereignis aus.Raises the CellClick event.

(Geerbt von DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Löst das CellContentClick-Ereignis aus.Raises the CellContentClick event.

(Geerbt von DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Löst das CellContentDoubleClick-Ereignis aus.Raises the CellContentDoubleClick event.

(Geerbt von DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Löst das CellValueChanged-Ereignis aus.Raises the CellValueChanged event.

(Geerbt von DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Löst das DataError-Ereignis aus.Raises the DataError event.

(Geerbt von DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Löst das MouseWheel-Ereignis aus.Raises the MouseWheel event.

(Geerbt von DataGridViewElement)
SetValues(Object[])

Legt die Werte für die Zellen der Zeile fest.Sets the values of the row's cells.

ToString()

Ruft eine Klartextzeichenfolge ab, die die Zeile beschreibt.Gets a human-readable string that describes the row.

Gilt für:

Siehe auch