DataGridView.ClearSelection 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

取消对当前选定的单元格的选择。

重载

ClearSelection(Int32, Int32, Boolean)	取消选择当前选定的所有单元格（所指示的单元格除外），可以选择确保所指示的单元格处于选定状态。
ClearSelection()	通过取消选择所有的选定单元格来清除当前的选择。

ClearSelection(Int32, Int32, Boolean)

取消选择当前选定的所有单元格（所指示的单元格除外），可以选择确保所指示的单元格处于选定状态。

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)

参数

columnIndexException

Int32

要排除的列索引。

rowIndexException

Int32

要排除的行索引。

selectExceptionElement

Boolean

如果要选择已排除的单元格、行或列，则为 true；如果要保留它的初始状态，则为 false。

例外

ArgumentOutOfRangeException

columnIndexException 大于最高的列索引。

• 或 - 当 SelectionMode 为 FullRowSelect 时，columnIndexException 小于 -1；否则 columnIndexException 小于 0。

• 或 - rowIndexException 大于最高的行索引。

• 或 - 当 SelectionMode 为 FullColumnSelect 时，rowIndexException 小于 -1；否则 rowIndexException 小于 0。

注解

rowIndexException值 -1 表示列标题，columnIndexException值为 -1 表示行标题。

此方法可用于清除当前所选内容，而无需取消异常索引所指示的单元格、行或列的选择。

SelectionMode如果属性值允许单个单元格选择，此方法会将每个单元格的属性设置为Selectedfalse，不包括指定的行和列中的单元格。 SelectionMode如果属性值允许完整行或列选择，此方法还会将每一行或列的属性设置为Selectedfalse，不包括包含指定单元格的行或列。

调用此方法时，排除的单元格、行或列可能处于所选状态。 如果参数值为 true，则此方法选择它selectExceptionElement。 根据选择模式，也可以选择整个行或列作为结果。

另请参阅

• SelectionMode
• Selected
• Selected
• DataGridView 控件（Windows 窗体）

ClearSelection()

通过取消选择所有的选定单元格来清除当前的选择。

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

示例

下面的代码示例清除所选内容 DataGridView。 若要运行此示例，请将代码粘贴到包含 DataGridView 命名 dataGridView1 和 Button 命名 clearSelectionButton的窗体中，并确保所有事件都与其事件处理程序相关联。

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

注解

调用此方法时，将每个列和行 Selected 的属性设置为 false。

另请参阅

• DataGridView 控件（Windows 窗体）