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如果屬性值允許個別儲存格選取，這個方法會將每個儲存格的 屬性設定 Selected 為 false ，不包括指定之列和資料行中的儲存格。 SelectionMode如果屬性值允許完整資料列或資料行選取，這個方法也會將每個資料列或資料行的 屬性設定 Selected 為 false ，不包括包含指定儲存格的資料列或資料行。

呼叫此方法時，排除的資料格、資料列或資料行可能處於選取狀態。 如果參數值為 true ， selectExceptionElement 這個方法會選取它。 視選取模式而定，也可能選取整個資料列或資料行作為結果。

另請參閱

• SelectionMode
• Selected
• Selected
• DataGridView 控制項 (Windows Form)

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 Form)