BindingSource.Find Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Znajdź określony element w źródle danych.

Przeciążenia

Find(PropertyDescriptor, Object)	Wyszukuje indeks elementu, który ma dany deskryptor właściwości.
Find(String, Object)	Zwraca indeks elementu na liście z określoną nazwą właściwości i wartością.

Find(PropertyDescriptor, Object)

Wyszukuje indeks elementu, który ma dany deskryptor właściwości.

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

Parametry

prop

PropertyDescriptor

Element do wyszukania PropertyDescriptor .

key

Object

Wartość, która ma być zgodna prop .

Zwraca

Int32

Indeks zerowy elementu, który ma daną wartość dla PropertyDescriptorelementu .

Implementuje

Find(PropertyDescriptor, Object)

Wyjątki

NotSupportedException

Lista bazowa nie jest typu IBindingList.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać Find metody . Pełny przykład można znaleźć w temacie omówienie klasy.

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

Uwagi

Ta metoda jest zwykle używana w złożonych przypadkach powiązania danych w celu zlokalizowania pierwszego wiersza, w którym wartość pola określonego przez prop parametr jest równa wartości parametru key

Ta metoda po prostu odwołuje się do metody listy bazowej IBindingList.Find . Jeśli na przykład bazowe źródło danych to DataSet, DataTablelub DataView, ta metoda wywołuje metodę DataView.IBindingList.Find . Zachowanie elementu IBindingList.Find, takie jak wartość zwrócona, jeśli nie znaleziono pasującego elementu, zależy od implementacji metody na liście bazowej.

Zobacz też

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

Find(String, Object)

Zwraca indeks elementu na liście z określoną nazwą właściwości i wartością.

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

Parametry

propertyName

String

Nazwa właściwości do wyszukania.

key

Object

Wartość elementu z określonym propertyName do znalezienia.

Zwraca

Int32

Indeks zerowy elementu o określonej nazwie i wartości właściwości.

Wyjątki

InvalidOperationException

Lista bazowa nie IBindingList jest funkcją wyszukiwania zaimplementowaną.

ArgumentException

propertyName nie jest zgodna z właściwością na liście.

Przykłady

W poniższym przykładzie pokazano, jak używać Find metody z elementem DataView. Aby uruchomić ten przykład, wklej kod do formularza systemu Windows i wywołaj PopulateDataViewAndFind metodę z konstruktora formularza lub Load metody obsługi zdarzeń. Formularz powinien importować System.Xml przestrzenie nazw i 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

Uwagi

Metoda Find może być używana tylko wtedy, gdy lista bazowa jest elementem z zaimplementowanym wyszukiwaniem IBindingList . Ta metoda po prostu odwołuje się do metody listy bazowej IBindingList.Find . Jeśli na przykład bazowe źródło danych to , lub , ta metoda jest konwertowana propertyName na metodę PropertyDescriptor i wywołuje metodę IBindingList.Find .DataViewDataTableDataSet Zachowanie elementu Find, takie jak wartość zwrócona, jeśli nie znaleziono pasującego elementu, zależy od implementacji metody na liście bazowej.

Porównanie nazw właściwości jest bez uwzględniania wielkości liter.