Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Développer Réduire

DataGridView.SortedColumn, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient la colonne selon laquelle le contenu du DataGridView est actuellement trié.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public DataGridViewColumn SortedColumn { get; }
/** @property */
public DataGridViewColumn get_SortedColumn ()

public function get SortedColumn () : DataGridViewColumn

Valeur de la propriété

DataGridViewColumn selon lequel le contenu de DataGridView est actuellement trié.

Si le DataGridView n'est pas trié, cette propriété retourne référence Null (Nothing en Visual Basic).

Lorsque la colonne indiquée par cette propriété a une valeur de la propriété SortMode égale à DataGridViewColumnSortMode.Automatic, elle affiche un glyphe de tri basé sur la valeur de la propriété SortOrder.

Lorsque la colonne a une valeur de la propriété SortMode égale à DataGridViewColumnSortMode.Programmatic, vous devez afficher vous-même le glyphe de tri via la propriété DataGridViewColumnHeaderCell.SortGlyphDirection.

RemarqueRemarque

La valeur de cette propriété n'est pas significative lorsque vous triez le contrôle à l'aide du tri personnalisé. Pour plus d'informations sur le tri personnalisé, consultez la méthode Sort(IComparer) et l'événement SortCompare.

L'exemple de code suivant montre comment utiliser la propriété SortedColumn dans un tri par programme.

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;
    }
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft