BindingSource.Filter 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

BindingSource.cs

표시할 행을 필터링하는 데 사용하는 식을 가져오거나 설정합니다.

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

public virtual string? Filter { get; set; }

member this.Filter : string with get, set

Public Overridable Property Filter As String

속성 값

String

행의 필터링 방법을 지정하는 문자열입니다. 기본값은 null입니다.

구현

Filter

예제

다음 예제에서는 사용 하는 방법을 보여 줍니다 합니다 Filter 속성을 DataView입니다. 이 예제를 실행 하려면 호출을 Windows Form에 코드를 붙여넣은 PopulateDataViewAndFilter 폼의 생성자에서 또는 Load 이벤트 처리 메서드. 폼을 가져와야 합니다 System.Xml 및 System.IO 네임 스페이스입니다.

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

설명

복잡 한 데이터 바인딩 시나리오에서 일반적으로 사용 합니다 Filter 속성의 하위 집합을 볼 수 있습니다는 DataSource합니다. 기본 목록 에서만 구현 하는 IBindingListView 인터페이스 필터링을 지원 합니다.

때 Filter 아닙니다 null는 BindingSource 내부 목록에이 속성을 전달 합니다. 개체 초기화 하는 동안이 속성을 설정 하는 경우 초기화가 완료 된 후 호출 될 때까지 지연 됩니다.

필터 값을 양식의 뒤 운영자와 값을 필터링 할 열의 이름을 지정 합니다. 수락 된 필터 구문은 데이터 원본에 따라 달라 집니다. 데이터 원본의 경우는 DataSet, DataTable, 또는 DataView, 부울 식에 대해 문서화 된 구문을 사용 하 여 지정할 수 있습니다는 DataColumn.Expression 속성입니다.

값을 Filter 속성의 값에 영향을 줍니다는 Count 속성입니다. 또한는 Filter 값 데이터 소스가 변경 되어도 유지 됩니다. 필터링을 중지 하려면 합니다 DataSource를 호출 합니다 RemoveFilter 메서드.

추가 정보

• DataSource
• List
• Sort
• RemoveFilter()
• IsSorted