DataGridView.CurrentCell Eigenschaft

Definition

Ruft die derzeit aktive Zelle ab oder legt sie fest.Gets or sets the currently active cell.

public:
 property System::Windows::Forms::DataGridViewCell ^ CurrentCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell CurrentCell { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property CurrentCell As DataGridViewCell

Eigenschaftswert

DataGridViewCell

Der DataGridViewCell, die die aktive Zelle darstellt, oder null, wenn keine aktive Zelle vorliegt.The DataGridViewCell that represents the current cell, or null if there is no current cell. Der Standard ist die erste Zelle in der ersten Spalte oder null, wenn keine Zellen im Steuerelement vorhanden sind.The default is the first cell in the first column or null if there are no cells in the control.

Attribute

Ausnahmen

Der Wert dieser Eigenschaft kann nicht festgelegt werden, da Änderungen an der aktuellen Zelle nicht zugesichert oder abgebrochen werden können.The value of this property cannot be set because changes to the current cell cannot be committed or canceled.

- oder --or- Die beim Festlegen dieser Eigenschaft angegebene Zelle befindet sich in einer ausgeblendeten Zeile oder Spalte.The specified cell when setting this property is in a hidden row or column.

Das eintrittsinvariante Aufrufen ist nur zulässig, wenn DataGridView an ein DataSource gebunden ist.Re-entrant calling is only allowed when the DataGridView is bound to a DataSource. Das eintrittsinvariante Aufrufen ergibt sich durch die Änderung an den zugrunde liegenden Daten.Re-entrant calling results from a change to the underlying data.

Die beim Festlegen dieser Eigenschaft angegebene Zelle befindet sich nicht in der DataGridView.The specified cell when setting this property is not in the DataGridView.

Beispiele

Das folgende Codebeispiel veranschaulicht, wie sichergestellt wird, dass die aktuelle Zelle nach dem Sortieren sichtbar ist, indem die- FirstDisplayedCell Eigenschaft auf die durch die-Eigenschaft abgerufene Zelle festgelegt wird CurrentCell .The following code example illustrates how to ensure that the current cell is visible after sorting by setting the FirstDisplayedCell property to the cell retrieved through the CurrentCell property. Dieser Code funktioniert nur mit einem ungebundenen DataGridView Steuerelement.This code works only with an unbound DataGridView control. Wenn ein DataGridView Steuerelement an eine externe Datenquelle gebunden ist, wird die aktuelle Zelle beim Sortieren nicht automatisch persistent gespeichert.With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.

Fügen Sie den folgenden Code in ein Formular ein, das einen mit dem Namen enthält, um dieses Beispiel auszuführen DataGridView dataGridView1 .To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. In c# müssen Sie auch das Sorted Ereignis mit dem Ereignishandler verbinden.In C#, you must also connect the Sorted event to the event handler.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}
Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

Hinweise

Wenn Sie eine Zelle als aktive Zelle festlegen, wird Sie in der Ansicht angezeigt, wenn Sie derzeit nicht angezeigt wird.When you set a cell as the current cell, it will scroll into view if it is not currently displayed. Bei der aktuellen Zelle kann es sich nicht um eine Header Zelle, eine deaktivierte Zelle oder eine Zelle in einer verborgenen Zeile oder Spalte handeln.The current cell cannot be a header cell, a disabled cell, or a cell in a hidden row or column.

Sie können diese Eigenschaft auf festlegen, null um das Fokus Rechteck vorübergehend zu entfernen, aber wenn das Steuerelement den Fokus erhält und der Wert dieser Eigenschaft ist null , wird es automatisch auf den Wert der-Eigenschaft festgelegt FirstDisplayedCell .You can set this property to null to temporarily remove the focus rectangle, but when the control receives focus and the value of this property is null, it is automatically set to the value of the FirstDisplayedCell property.

Wenn Sie den Wert dieser Eigenschaft ändern, tritt das SelectionChanged Ereignis vor dem- CurrentCellChanged Ereignis auf.When you change the value of this property, the SelectionChanged event occurs before the CurrentCellChanged event. Jeder SelectionChanged Ereignishandler, der CurrentCell zu diesem Zeitpunkt auf die Eigenschaft zugreift, erhält seinen vorherigen Wert.Any SelectionChanged event handler accessing the CurrentCell property at this time will get its previous value.

Wenn Sie das DataGridView an eine externe Datenquelle binden, wird diese Eigenschaft auf ihren Standardwert zurückgesetzt.When you bind the DataGridView to an external data source, this property is reset to its default value.

Gilt für:

Weitere Informationen