BindingSource.Find Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Temukan item yang ditentukan di sumber data.

Overload

Find(PropertyDescriptor, Object)	Mencari indeks item yang memiliki pendeskripsi properti yang diberikan.
Find(String, Object)	Mengembalikan indeks item dalam daftar dengan nama dan nilai properti yang ditentukan.

Find(PropertyDescriptor, Object)

Mencari indeks item yang memiliki pendeskripsi properti yang diberikan.

public:
 virtual int Find(System::ComponentModel::PropertyDescriptor ^ prop, System::Object ^ key);

public virtual int Find (System.ComponentModel.PropertyDescriptor prop, object key);

abstract member Find : System.ComponentModel.PropertyDescriptor * obj -> int
override this.Find : System.ComponentModel.PropertyDescriptor * obj -> int

Public Overridable Function Find (prop As PropertyDescriptor, key As Object) As Integer

Parameter

prop

PropertyDescriptor

untuk PropertyDescriptor mencari.

key

Object

Nilai yang prop akan dicocokkan.

Mengembalikan

Int32

Indeks berbasis nol dari item yang memiliki nilai yang diberikan untuk PropertyDescriptor.

Penerapan

Find(PropertyDescriptor, Object)

Pengecualian

NotSupportedException

Daftar yang mendasar tidak berjenis IBindingList.

Contoh

Contoh kode berikut menunjukkan cara menggunakan Find metode . Untuk contoh lengkapnya, lihat topik gambaran umum kelas.

private void button1_Click(object sender, EventArgs e)
{
    if (binding1.SupportsSearching != true)
    {
        MessageBox.Show("Cannot search the list.");
    }
    else
    {
        int foundIndex = binding1.Find("Name", textBox1.Text);
        if (foundIndex > -1)
            listBox1.SelectedIndex = foundIndex;
        else
            MessageBox.Show("Font was not found.");
    }
}

    Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles button1.Click

        If binding1.SupportsSearching <> True Then
            MessageBox.Show("Cannot search the list.")
        Else
            Dim foundIndex As Integer = binding1.Find("Name", textBox1.Text)
            If foundIndex > -1 Then
                listBox1.SelectedIndex = foundIndex
            Else
                MessageBox.Show("Font was not found.")
            End If
        End If

    End Sub
End Class

Keterangan

Metode ini biasanya digunakan dalam kasus pengikatan data kompleks untuk menemukan baris pertama di mana nilai bidang yang ditentukan oleh parameter sama dengan prop nilai key parameter

Metode ini hanya mengacu pada permintaan ke metode daftar yang mendasar IBindingList.Find . Misalnya, jika sumber data yang mendasar DataView.IBindingList.Find adalah DataSet, , DataTableatau DataView, metode ini memanggil metode . Perilaku IBindingList.Find, seperti nilai yang dikembalikan jika tidak ada item yang cocok yang ditemukan, tergantung pada implementasi metode dalam daftar yang mendasar.

Lihat juga

• List
• IndexOf(Object)
• Contains(Object)
• Count
• Position
• Item[Int32]

Find(String, Object)

Mengembalikan indeks item dalam daftar dengan nama dan nilai properti yang ditentukan.

public:
 int Find(System::String ^ propertyName, System::Object ^ key);

public int Find (string propertyName, object key);

member this.Find : string * obj -> int

Public Function Find (propertyName As String, key As Object) As Integer

Parameter

propertyName

String

Nama properti yang akan dicari.

key

Object

Nilai item dengan yang ditentukan propertyName untuk ditemukan.

Mengembalikan

Int32

Indeks berbasis nol item dengan nama dan nilai properti yang ditentukan.

Pengecualian

InvalidOperationException

Daftar yang mendasar bukan dengan fungsi pencarian yang IBindingList diimplementasikan.

ArgumentException

propertyName tidak cocok dengan properti dalam daftar.

Contoh

Contoh berikut menunjukkan cara menggunakan Find metode dengan DataView. Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil PopulateDataViewAndFind dari konstruktor formulir atau Load metode penanganan peristiwa. Formulir Anda harus mengimpor System.Xml namespace dan System.IO .

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

    // Set the Position property to the results of the Find method.
    int itemFound = source1.Find("artist", "Natalie Merchant");
    source1.Position = itemFound;
}

Private Sub PopulateDataViewAndFind() 
    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>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
    
    ' Set the Position property to the results of the Find method.
    Dim itemFound As Integer = source1.Find("artist", "Natalie Merchant")
    source1.Position = itemFound

End Sub

Keterangan

Metode Find ini hanya dapat digunakan ketika daftar yang mendasar adalah dengan pencarian yang IBindingList diimplementasikan. Metode ini hanya mengacu pada permintaan ke metode daftar yang mendasar IBindingList.Find . Misalnya, jika sumber data yang mendasar adalah DataSet, , DataTableatau DataView, metode ini dikonversi menjadi PropertyDescriptor dan memanggil IBindingList.FindpropertyName metode . Perilaku Find, seperti nilai yang dikembalikan jika tidak ada item yang cocok yang ditemukan, tergantung pada implementasi metode dalam daftar yang mendasar.

Perbandingan nama properti tidak peka huruf besar/kecil.