BindingSource.Sort Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

BindingSource.cs

Ruft die spaltennamen ab, die zum Sortieren verwendet werden, und die Sortierreihenfolge zum Anzeigen der Zeilen in der Datenquelle.

public:
 property System::String ^ Sort { System::String ^ get(); void set(System::String ^ value); };

public string? Sort { get; set; }

member this.Sort : string with get, set

Public Property Sort As String

Eigenschaftswert

String

Eine Zeichenfolge mit Groß-/Kleinschreibung, die den Spaltennamen gefolgt von "ASC" (für aufsteigend) oder "DESC" (für absteigend) enthält. Der Standardwert lautet null.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Sort Eigenschaft verwenden, um eine einfache Sortierung mit einem DataView. Zum Ausführen dieses Beispiels fügen Sie den Code in ein Windows Form-Formular ein, und rufen Sie den Aufruf PopulateDataViewAndSort aus dem Konstruktor oder Load der Ereignisbehandlungsmethode des Formulars auf. Ihr Formular sollte die System.Xml Namespaces System.IO importieren.

private void PopulateDataViewAndSort()
{
    DataSet set1 = new DataSet();

    // Some xml data to populate the DataSet with.
    string musicXml =
        "<?xml version='1.0' encoding='UTF-8'?>" +
        "<music>" +
        "<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" +
        "<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" +
        "<recording><artist>Dave Matthews</artist><cd>Live at Red Rocks</cd></recording>" +
        "<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" +
        "<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" +
        "</music>";

    // Read the xml.
    StringReader reader = new StringReader(musicXml);
    set1.ReadXml(reader);

    // Get a DataView of the table contained in the dataset.
    DataTableCollection tables = set1.Tables;
    DataView view1 = new DataView(tables[0]);

    // Create a DataGridView control and add it to the form.
    DataGridView datagridview1 = new DataGridView();
    datagridview1.AutoGenerateColumns = true;
    this.Controls.Add(datagridview1);

    // Create a BindingSource and set its DataSource property to
    // the DataView.
    BindingSource source1 = new BindingSource();
    source1.DataSource = view1;

    // Set the data source for the DataGridView.
    datagridview1.DataSource = source1;

    source1.Sort = "cd";
}

Private Sub PopulateDataViewAndSort() 
    Dim set1 As New DataSet()
    
    ' Some xml data to populate the DataSet with.
    Dim musicXml As String = "<?xml version='1.0' encoding='UTF-8'?>" & _
        "<music>" & _
        "<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" & _
        "<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" & _
        "<recording><artist>Dave Matthews</artist><cd>Live at Red Rocks</cd></recording>" & _
        "<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" & _
        "<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" & _
         "</music>"
    
    ' Read the xml.
    Dim reader As New StringReader(musicXml)
    set1.ReadXml(reader)
    
    ' Get a DataView of the table contained in the dataset.
    Dim tables As DataTableCollection = set1.Tables
    Dim view1 As New DataView(tables(0))
    
    ' Create a DataGridView control and add it to the form.
    Dim datagridview1 As New DataGridView()
    datagridview1.AutoGenerateColumns = True
    Me.Controls.Add(datagridview1)
    
    ' Create a BindingSource and set its DataSource property to
    ' the DataView.
    Dim source1 As New BindingSource()
    source1.DataSource = view1
    
    ' Set the data source for the DataGridView.
    datagridview1.DataSource = source1
    
    source1.Sort = "cd"

End Sub

Das folgende Beispiel zeigt, wie Sie die Sort Eigenschaft verwenden, um eine erweiterte Sortierung mit einem DataView. Zum Ausführen dieses Beispiels fügen Sie den Code in ein Windows Form-Formular ein, und rufen Sie den Aufruf PopulateDataViewAndAdvancedSort aus dem Konstruktor oder Load der Ereignisbehandlungsmethode des Formulars auf. Ihr Formular sollte die System.Xml Namespaces System.IO importieren.

private void PopulateDataViewAndAdvancedSort()
{
    DataSet set1 = new DataSet();

    // Some xml data to populate the DataSet with.
    string musicXml =
        "<?xml version='1.0' encoding='UTF-8'?>" +
        "<music>" +
        "<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" +
        "<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" +
        "<recording><artist>Dave Matthews</artist><cd>Live at Red Rocks</cd></recording>" +
        "<recording><artist>U2</artist><cd>Joshua Tree</cd></recording>" +
        "<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" +
        "<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" +
        "</music>";

    // Read the xml.
    StringReader reader = new StringReader(musicXml);
    set1.ReadXml(reader);

    // Get a DataView of the table contained in the dataset.
    DataTableCollection tables = set1.Tables;
    DataView view1 = new DataView(tables[0]);

    // Create a DataGridView control and add it to the form.
    DataGridView datagridview1 = new DataGridView();
    datagridview1.AutoGenerateColumns = true;
    this.Controls.Add(datagridview1);

    // Create a BindingSource and set its DataSource property to
    // the DataView.
    BindingSource source1 = new BindingSource();
    source1.DataSource = view1;

    // Set the data source for the DataGridView.
    datagridview1.DataSource = source1;

    source1.Sort = "artist ASC, cd ASC";
}

Private Sub PopulateDataViewAndAdvancedSort() 
    Dim set1 As New DataSet()
    
    ' Some xml data to populate the DataSet with.
    Dim musicXml As String = "<?xml version='1.0' encoding='UTF-8'?>" & _
        "<music>" & _
        "<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" & _
        "<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" & _
        "<recording><artist>Dave Matthews</artist><cd>Live at Red Rocks</cd></recording>" & _
        "<recording><artist>U2</artist><cd>Joshua Tree</cd></recording>" & _
        "<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" & _
        "<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" & _
        "</music>"
    
    ' Read the xml.
    Dim reader As New StringReader(musicXml)
    set1.ReadXml(reader)
    
    ' Get a DataView of the table contained in the dataset.
    Dim tables As DataTableCollection = set1.Tables
    Dim view1 As New DataView(tables(0))
    
    ' Create a DataGridView control and add it to the form.
    Dim datagridview1 As New DataGridView()
    datagridview1.AutoGenerateColumns = True
    Me.Controls.Add(datagridview1)
    
    ' Create a BindingSource and set its DataSource property to
    ' the DataView.
    Dim source1 As New BindingSource()
    source1.DataSource = view1
    
    ' Set the data source for the DataGridView.
    datagridview1.DataSource = source1
    
    source1.Sort = "artist ASC, cd ASC"

Hinweise

Bei der Sort Eigenschaft handelt es sich um eine Zeichenfolge mit Groß-/Kleinschreibung, die die Spaltennamen angibt, mit denen die Zeilen sortiert werden, zusammen mit der Sortierrichtung. Spalten werden standardmäßig aufsteigend sortiert. Mehrere Spalten können durch Kommas getrennt werden, z. B "State, ZipCode DESC". .

Zur Unterstützung der Sortierung muss die zugrunde liegende Liste die IBindingList oder IBindingListView die Schnittstellen implementieren. Diese Funktion kann über die SupportsSorting Eigenschaft abgefragt werden. Die mehrspaltige Sortierung ist verfügbar, wenn die SupportsAdvancedSorting Eigenschaft ist true.

Durch Festlegen der Sort Eigenschaft wird die interne Liste je nach Typ geändert:

• Wenn die Liste vom Typ IBindingListist, werden die IBindingList.SortProperty Eigenschaften in IBindingList.SortDirection der internen Liste festgelegt.

• Wenn die Liste vom Typ IBindingListViewist, wird die IBindingListView.SortDescriptions Eigenschaft festgelegt.

Die Sortiereigenschaften der internen Liste werden nur geändert, wenn die Sortierzeichenfolge nicht nulllautet. Der get Accessor für diese Eigenschaft ruft nicht den Sortierwert der internen Liste ab. Stattdessen wird der set Accessorwert zurückgegeben. Der Wert der Sort Eigenschaft wird beibehalten, wenn sich die Datenquelle ändert.

Weitere Informationen

• Filter
• RemoveSort()