DataGridView.CurrentCell Eigenschaft

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.

Ruft die derzeit aktive Zelle ab oder legt sie fest.

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)]
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. Der Standard ist die erste Zelle in der ersten Spalte oder null, wenn keine Zellen im Steuerelement vorhanden sind.

Attribute: BrowsableAttribute

Ausnahmen

InvalidOperationException

Der Wert dieser Eigenschaft kann nicht festgelegt werden, da Änderungen an der aktuellen Zelle nicht zugesichert oder abgebrochen werden können.

- oder -

Die beim Festlegen dieser Eigenschaft angegebene Zelle befindet sich in einer ausgeblendeten Zeile oder Spalte.

Das eintrittsinvariante Aufrufen ist nur zulässig, wenn DataGridView an ein DataSource gebunden ist. Das eintrittsinvariante Aufrufen ergibt sich durch die Änderung an den zugrunde liegenden Daten.

ArgumentException

Die beim Festlegen dieser Eigenschaft angegebene Zelle befindet sich nicht in der DataGridView.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie sicherstellen, dass die aktuelle Zelle nach dem Sortieren sichtbar ist, indem Sie die FirstDisplayedCell -Eigenschaft auf die Zelle festlegen, die über die CurrentCell -Eigenschaft abgerufen wird. Dieser Code funktioniert nur mit einem ungebundenen DataGridView Steuerelement. Wenn ein DataGridView Steuerelement an eine externe Datenquelle gebunden ist, wird die aktuelle Zelle beim Sortieren nicht automatisch beibehalten.

Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das einen DataGridView namens dataGridView1enthält. In C# müssen Sie auch das Sorted Ereignis mit dem Ereignishandler verbinden.

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 aktuelle Zelle festlegen, scrollt sie in die Ansicht, wenn sie derzeit nicht angezeigt wird. Die aktuelle Zelle darf keine Kopfzeilenzelle, eine deaktivierte Zelle oder eine Zelle in einer ausgeblendeten Zeile oder Spalte sein.

Sie können diese Eigenschaft auf null festlegen, um das Fokusrechteck 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 FirstDisplayedCell Eigenschaft festgelegt.

Wenn Sie den Wert dieser Eigenschaft ändern, tritt das SelectionChanged Ereignis vor dem CurrentCellChanged Ereignis auf. Jeder SelectionChanged Ereignishandler, der zu diesem Zeitpunkt auf die CurrentCell Eigenschaft zugreift, erhält seinen vorherigen Wert.

Wenn Sie die DataGridView an eine externe Datenquelle binden, wird diese Eigenschaft auf den Standardwert zurückgesetzt.

Gilt für:

Freigeben über