DataGridView.SelectedRows 属性

定义

获取用户选定的行的集合。Gets the collection of rows selected by the user.

public:
 property System::Windows::Forms::DataGridViewSelectedRowCollection ^ SelectedRows { System::Windows::Forms::DataGridViewSelectedRowCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewSelectedRowCollection SelectedRows { get; }
member this.SelectedRows : System.Windows.Forms.DataGridViewSelectedRowCollection
Public ReadOnly Property SelectedRows As DataGridViewSelectedRowCollection

属性值

一个 DataGridViewSelectedRowCollection,包含用户选定的行。A DataGridViewSelectedRowCollection that contains the rows selected by the user.

属性

示例

下面的代码示例演示如何使用 UserDeletingRow 事件中的 SelectedRows 属性。The following code example demonstrates how to use the SelectedRows property in the UserDeletingRow event. 在此示例中,如果 SelectedRows 集合中包含第一行,则取消删除操作。In this example, if the first row is contained in the SelectedRows collection, then the deletion is canceled. 此示例是 SelectionChanged 事件中提供的更大示例的一部分。This example is part of a larger example available in the SelectionChanged event.

private void DataGridView1_UserDeletingRow(object sender,
    DataGridViewRowCancelEventArgs e)
{
    DataGridViewRow startingBalanceRow = DataGridView1.Rows[0];

    // Check if the Starting Balance row is included in the selected rows
    if (DataGridView1.SelectedRows.Contains(startingBalanceRow))
    {
        // Do not allow the user to delete the Starting Balance row.
        MessageBox.Show("Cannot delete Starting Balance row!");

        // Cancel the deletion if the Starting Balance row is included.
        e.Cancel = true;
    }
}
Private Sub UserDeletingRow(ByVal sender As Object, _
    ByVal e As DataGridViewRowCancelEventArgs) _
    Handles DataGridView1.UserDeletingRow

    Dim startingBalanceRow As DataGridViewRow = DataGridView1.Rows(0)

    ' Check if the starting balance row is included in the selected rows
    If DataGridView1.SelectedRows.Contains(startingBalanceRow) Then
        ' Do not allow the user to delete the Starting Balance row.
        MessageBox.Show("Cannot delete Starting Balance row!")

        ' Cancel the deletion if the Starting Balance row is included.
        e.Cancel = True
    End If
End Sub

注解

SelectionMode 属性必须设置为 FullRowSelectRowHeaderSelect,才能用所选行填充 SelectedRows 属性。The SelectionMode property must be set to FullRowSelect or RowHeaderSelect for the SelectedRows property to be populated with selected rows.

此属性包含所选内容在引用时的只读快照。This property contains a read-only snapshot of the selection at the time it is referenced. 如果你保存在此集合的副本上,则它可能与实际的 DataGridView 状态不同,用户可能已更改了所选内容。If you hold onto a copy of this collection, it may differ from the actual, subsequent DataGridView state in which the user may have changed the selection. 因此,不应在集合的副本上进行操作。You should therefore not operate on a copy of the collection.

若要以编程方式选择行,请将其 Selected 属性设置为 trueTo programmatically select a row, set its Selected property to true.

适用于

另请参阅