DataGridViewColumn.SortMode Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit le mode de tri de la colonne.

public:
 property System::Windows::Forms::DataGridViewColumnSortMode SortMode { System::Windows::Forms::DataGridViewColumnSortMode get(); void set(System::Windows::Forms::DataGridViewColumnSortMode value); };
public System.Windows.Forms.DataGridViewColumnSortMode SortMode { get; set; }
member this.SortMode : System.Windows.Forms.DataGridViewColumnSortMode with get, set
Public Property SortMode As DataGridViewColumnSortMode

Valeur de propriété

DataGridViewColumnSortMode

Un DataGridViewColumnSortMode qui spécifie les critères utilisés pour commander les lignes en fonction des valeurs de cellules dans une colonne.

Exceptions

InvalidOperationException

La valeur assignée à la propriété est en conflit avec SelectionMode.

Exemples

L’exemple de code suivant montre comment utiliser la SortMode propriété .

this.dataGridView1.Columns["Priority"].SortMode =
    DataGridViewColumnSortMode.Automatic;

Me.dataGridView1.Columns("Priority").SortMode = _
    DataGridViewColumnSortMode.Automatic

Remarques

Lorsqu’un DataGridView contrôle est trié à l’aide d’une colonne avec la SortMode valeur de Automaticpropriété , un glyphe de tri s’affiche automatiquement dans l’en-tête de colonne.

À compter de .NET Framework 4.6, le glyphe de tri est redimensionné en fonction des paramètres ppp système lorsque le fichier app.config contient l’entrée suivante :

<appSettings>  
  <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  
</appSettings>

Lorsque le contrôle est trié à l’aide d’une colonne avec la SortMode valeur de Programmaticpropriété , vous devez afficher vous-même le glyphe de tri via la SortGlyphDirection propriété .

Le mode de tri par défaut d’un DataGridViewTextBoxColumn est Automatic. Le mode de tri par défaut pour les autres types de colonnes est NotSortable.

La SortMode valeur ne vous empêche pas de trier une colonne par programmation, bien que d’autres restrictions puissent s’appliquer. Pour plus d'informations, voir la méthode Sort.

Une SortMode valeur de propriété de NotSortable n’empêche pas l’événement DataGridView.ColumnHeaderMouseClick de se produire, mais elle empêche l’en-tête de modifier son apparence lorsque l’utilisateur clique dessus.

S’applique à

Voir aussi