BindingSource.Filter Özellik

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Hangi satırların görüntüleneceğini filtrelemek için kullanılan ifadeyi alır veya ayarlar.

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

public virtual string Filter { get; set; }

public virtual string? Filter { get; set; }

member this.Filter : string with get, set

Public Overridable Property Filter As String

Özellik Değeri

String

Satırların nasıl filtrelendiğini belirten bir dize. Varsayılan değer: null.

Uygulamalar

Filter

Örnekler

Aşağıdaki örnekte özelliğinin Filter ile DataViewnasıl kullanılacağı gösterilmektedir. Bu örneği çalıştırmak için, kodu bir Windows Formuna yapıştırın ve formun oluşturucusundan veya Load olay işleme yönteminden çağırınPopulateDataViewAndFilter. Formunuzun ve System.IO ad alanlarını içeri aktarması System.Xml gerekir.

private void PopulateDataViewAndFilter()
{
    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;

    //The Filter string can include Boolean expressions.
    source1.Filter = "artist = 'Dave Matthews' OR cd = 'Tigerlily'";
}

Private Sub PopulateDataViewAndFilter() 
    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
    
    ' The Filter string can include Boolean expressions.
    source1.Filter = "artist = 'Dave Matthews' OR cd = 'Tigerlily'"

End Sub

Açıklamalar

Genellikle karmaşık veri bağlama senaryolarında kullanılan özelliği, öğesinin Filter DataSourcebir alt kümesini görüntülemenizi sağlar. Yalnızca arabirim desteği filtrelemesini IBindingListView uygulayan temel listeler.

değil nullolduğundaFilter, BindingSource bu özelliği temel alınan listeye geçirir. Nesne başlatma sırasında bu özelliği ayarlarsanız, başlatma tamamlanana kadar çağrı ertelenir.

Filtre değeri oluşturmak için, bir sütunun adını ve ardından bir işleç ve filtre uygulanacak değeri belirtin. Kabul edilen filtre söz dizimi, temel alınan veri kaynağına bağlıdır. Temel alınan veri kaynağı bir DataSet, DataTableveya DataViewise, özelliği için DataColumn.Expression belgelenen söz dizimini kullanarak Boole ifadeleri belirtebilirsiniz.

özelliğinin Filter değeri özelliğin Count değerini etkiler. Ayrıca, Filter veri kaynağı değiştiğinde değer kalıcı olur. filtresini DataSourcedurdurmak için yöntemini çağırın RemoveFilter .

Şunlara uygulanır

Aracılığıyla paylaş