DataGridView.SortedColumn Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Spalte ab, nach der der DataGridView-Inhalt gerade sortiert wird.

public:
 property System::Windows::Forms::DataGridViewColumn ^ SortedColumn { System::Windows::Forms::DataGridViewColumn ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewColumn SortedColumn { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SortedColumn : System.Windows.Forms.DataGridViewColumn

Public ReadOnly Property SortedColumn As DataGridViewColumn

Eigenschaftswert

DataGridViewColumn

Die DataGridViewColumn, nach der der DataGridView-Inhalt gerade sortiert wird.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SortedColumn -Eigenschaft in einer programmgesteuerten Sortierung verwendet wird.

private void sortButton_Click(object sender, System.EventArgs e)
{
    // Check which column is selected, otherwise set NewColumn to null.
    DataGridViewColumn newColumn =
        dataGridView1.Columns.GetColumnCount(
        DataGridViewElementStates.Selected) == 1 ?
        dataGridView1.SelectedColumns[0] : null;

    DataGridViewColumn oldColumn = dataGridView1.SortedColumn;
    ListSortDirection direction;

    // If oldColumn is null, then the DataGridView is not currently sorted.
    if (oldColumn != null)
    {
        // Sort the same column again, reversing the SortOrder.
        if (oldColumn == newColumn &&
            dataGridView1.SortOrder == SortOrder.Ascending)
        {
            direction = ListSortDirection.Descending;
        }
        else
        {
            // Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending;
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None;
        }
    }
    else
    {
        direction = ListSortDirection.Ascending;
    }

    // If no column has been selected, display an error dialog  box.
    if (newColumn == null)
    {
        MessageBox.Show("Select a single column and try again.",
            "Error: Invalid Selection", MessageBoxButtons.OK,
            MessageBoxIcon.Error);
    }
    else
    {
        dataGridView1.Sort(newColumn, direction);
        newColumn.HeaderCell.SortGlyphDirection =
            direction == ListSortDirection.Ascending ?
            SortOrder.Ascending : SortOrder.Descending;
    }
}

Private Sub SortButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles sortButton.Click

    ' Check which column is selected, otherwise set NewColumn to Nothing.
    Dim newColumn As DataGridViewColumn
    If dataGridView1.Columns.GetColumnCount(DataGridViewElementStates _
        .Selected) = 1 Then
        newColumn = dataGridView1.SelectedColumns(0)
    Else
        newColumn = Nothing
    End If

    Dim oldColumn As DataGridViewColumn = dataGridView1.SortedColumn
    Dim direction As ListSortDirection

    ' If oldColumn is null, then the DataGridView is not currently sorted.
    If oldColumn IsNot Nothing Then

        ' Sort the same column again, reversing the SortOrder.
        If oldColumn Is newColumn AndAlso dataGridView1.SortOrder = _
            SortOrder.Ascending Then
            direction = ListSortDirection.Descending
        Else

            ' Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None
        End If
    Else
        direction = ListSortDirection.Ascending
    End If


    ' If no column has been selected, display an error dialog  box.
    If newColumn Is Nothing Then
        MessageBox.Show("Select a single column and try again.", _
            "Error: Invalid Selection", MessageBoxButtons.OK, _
            MessageBoxIcon.Error)
    Else
        dataGridView1.Sort(newColumn, direction)
        If direction = ListSortDirection.Ascending Then
            newColumn.HeaderCell.SortGlyphDirection = SortOrder.Ascending
        Else
            newColumn.HeaderCell.SortGlyphDirection = SortOrder.Descending
        End If
    End If

End Sub

Hinweise

Wenn der DataGridView nicht sortiert ist, gibt diese Eigenschaft zurück null.

Wenn die von dieser Eigenschaft angegebene Spalte den SortMode Eigenschaftswert aufweist DataGridViewColumnSortMode.Automatic, wird eine Sortier-Glyphe basierend auf dem Wert der SortOrder -Eigenschaft angezeigt.

Wenn die Spalte den SortMode Eigenschaftswert hat DataGridViewColumnSortMode.Programmatic, müssen Sie die Sortier-Glyphe selbst über die DataGridViewColumnHeaderCell.SortGlyphDirection -Eigenschaft anzeigen.

Hinweis

Der Wert dieser Eigenschaft ist nicht sinnvoll, wenn Sie das Steuerelement mithilfe einer benutzerdefinierten Sortierung sortieren. Weitere Informationen zur benutzerdefinierten Sortierung finden Sie in der Sort(IComparer) Methode und im SortCompare Ereignis.

Weitere Informationen

• DataGridView-Steuerelement (Windows Forms)