DataGridView.ClearSelection Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Bricht die Auswahl der aktuell ausgewählten Zellen ab.

Überlädt

Name	Beschreibung
ClearSelection(Int32, Int32, Boolean)	Bricht die Auswahl aller aktuell markierten Zellen ab, mit Ausnahme der angegebenen, wobei optional sichergestellt wird, dass die angegebene Zelle ausgewählt ist.
ClearSelection()	Löscht die aktuelle Markierung, indem alle markierten Zellen deaktiviert werden.

ClearSelection(Int32, Int32, Boolean)

Quelle:

DataGridView.Methods.cs

Bricht die Auswahl aller aktuell markierten Zellen ab, mit Ausnahme der angegebenen, wobei optional sichergestellt wird, dass die angegebene Zelle ausgewählt ist.

protected:
 void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

protected void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

member this.ClearSelection : int * int * bool -> unit

Protected Sub ClearSelection (columnIndexException As Integer, rowIndexException As Integer, selectExceptionElement As Boolean)

Parameter

columnIndexException

Int32

Der auszuschließende Spaltenindex.

rowIndexException

Int32

Der auszuschließende Zeilenindex.

selectExceptionElement

Boolean

true um die ausgeschlossene Zelle, Zeile oder Spalte auszuwählen; false den ursprünglichen Zustand beizubehalten.

Ausnahmen

ArgumentOutOfRangeException

columnIndexException ist größer als der höchste Spaltenindex.

- oder -

columnIndexException ist kleiner als -1, wenn SelectionMode ist FullRowSelect; andernfalls columnIndexException ist weniger als 0.

- oder -

rowIndexException ist größer als der höchste Zeilenindex.

- oder -

rowIndexException ist kleiner als -1, wenn SelectionMode ist FullColumnSelect; andernfalls rowIndexException ist weniger als 0.

Hinweise

Ein rowIndexException Wert von -1 stellt eine Spaltenüberschrift dar, und ein columnIndexException Wert von -1 stellt eine Zeilenüberschrift dar.

Diese Methode ist nützlich, um die aktuelle Auswahl zu löschen, ohne die Auswahl der Zelle, Zeile oder Spalte, die durch die Ausnahmeindizes angegeben ist, abzubrechen.

Wenn der SelectionMode Eigenschaftswert einzelne Zellauswahl zulässt, legt diese Methode die Selected Eigenschaft jeder Zelle auf false, mit Ausnahme der Zelle in der angegebenen Zeile und Spalte. Wenn der SelectionMode Eigenschaftswert die vollständige Zeilen- oder Spaltenauswahl zulässt, legt diese Methode auch die Selected Eigenschaft jeder Zeile oder Spalte auf false, mit Ausnahme der Zeile oder Spalte, die die angegebene Zelle enthält.

Die ausgeschlossene Zelle, Zeile oder Spalte kann sich im ausgewählten Zustand befinden, wenn diese Methode aufgerufen wird. Diese Methode wählt sie aus, wenn der selectExceptionElement Parameterwert lautet true. Je nach Auswahlmodus kann auch die gesamte Zeile oder Spalte als Ergebnis ausgewählt werden.

Weitere Informationen

• SelectionMode
• Selected
• Selected
• DataGridView-Steuerelement (Windows Forms)

ClearSelection()

Quelle:

DataGridView.Methods.cs

Löscht die aktuelle Markierung, indem alle markierten Zellen deaktiviert werden.

public:
 void ClearSelection();

public void ClearSelection();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Beispiele

Im folgenden Codebeispiel wird die Auswahl der DataGridView. Zum Ausführen dieses Beispiels fügen Sie den Code in ein Formular ein, das einen DataGridView benannten und einen Button benannten dataGridView1clearSelectionButtonNamen enthält, und stellen Sie sicher, dass alle Ereignisse ihren Ereignishandlern zugeordnet sind.

private void clearSelectionButton_Click(object sender, EventArgs e)
{
    dataGridView1.ClearSelection();
}

Private Sub clearSelectionButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles clearSelectionButton.Click

    dataGridView1.ClearSelection()

End Sub

Hinweise

Wenn diese Methode aufgerufen wird, wird jede Spalte und Zeile-Eigenschaft Selected auf festgelegt false.

Weitere Informationen

• DataGridView-Steuerelement (Windows Forms)