DataGrid.SelectionMode Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the selection behavior of the data grid.

Namespace:  System.Windows.Controls
Assembly:  System.Windows.Controls.Data (in System.Windows.Controls.Data.dll)


Public Property SelectionMode As DataGridSelectionMode
public DataGridSelectionMode SelectionMode { get; set; }
<sdk:DataGrid SelectionMode="dataGridSelectionModeValue"/>

XAML Values

  • dataGridSelectionModeValue
    A named constant of the DataGridSelectionMode enumeration, such as Extended.

Property Value

Type: System.Windows.Controls.DataGridSelectionMode
One of the enumeration values specifying the selection behavior. The default is Extended.


Dependency property identifier field: SelectionModeProperty

Set the SelectionMode to specify whether users can select multiple rows or only a single row at a time.


The following code example demonstrates how to set the SelectionMode property in code. This example is part of a larger example available in the Walkthrough: Customizing the DataGrid Control Using Properties topic.

Private Sub cbSelectionMode_Changed(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs)
    Dim cb As CheckBox = sender
    If Me.dataGrid1 IsNot Nothing Then
        If cb.IsChecked = True Then
            Me.dataGrid1.SelectionMode = DataGridSelectionMode.Single
        ElseIf cb.IsChecked = False Then
            Me.dataGrid1.SelectionMode = DataGridSelectionMode.Extended
        End If
    End If
End Sub
private void cbSelectionMode_Changed(object sender, RoutedEventArgs e)
    CheckBox cb = sender as CheckBox;
    if (this.dataGrid1 != null)
        if (cb.IsChecked == true)
            this.dataGrid1.SelectionMode = DataGridSelectionMode.Single;
        else if (cb.IsChecked == false)
            this.dataGrid1.SelectionMode = DataGridSelectionMode.Extended;

Version Information


Supported in: 5, 4, 3


For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also


Other Resources