BindingSource.Find Metoda

Definicja

Znajdź określony element w źródle danych.Find the specified item in the data source.

Przeciążenia

Find(PropertyDescriptor, Object)

Wyszukuje indeks elementu, który ma dany deskryptor właściwości.Searches for the index of the item that has the given property descriptor.

Find(String, Object)

Zwraca indeks elementu na liście z określoną nazwą właściwości i wartością.Returns the index of the item in the list with the specified property name and value.

Find(PropertyDescriptor, Object)

Wyszukuje indeks elementu, który ma dany deskryptor właściwości.Searches for the index of the item that has the given property descriptor.

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

PropertyDescriptorAby wyszukać.The PropertyDescriptor to search for.

key
Object

Wartość prop do dopasowania.The value of prop to match.

Zwraca

Int32

Indeks (liczony od zera) elementu, który ma daną wartość dla PropertyDescriptor .The zero-based index of the item that has the given value for PropertyDescriptor.

Implementuje

Wyjątki

Lista podstawowa nie jest typu IBindingList .The underlying list is not of type IBindingList.

Przykłady

Poniższy przykład kodu demonstruje sposób używania Find metody.The following code example demonstrates how to use the Find method. Aby zapoznać się z kompletnym przykładem, zobacz temat Omówienie klas.For the complete example see the class overview topic.

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ązań danych, aby zlokalizować pierwszy wiersz, w którym wartość pola określonego przez prop parametr jest równa wartości key parametruThis method is typically used in complex data-binding cases to locate the first row where the value of the field specified by the prop parameter equals the value of the key parameter

Ta metoda po prostu przywołuje żądanie do metody podstawowej listy IBindingList.Find .This method simply refers the request to the underlying list's IBindingList.Find method. Na przykład, jeśli źródłowe źródło danych jest DataSet , DataTable , lub DataView , metoda wywołuje DataView.IBindingList.Find metodę.For example, if the underlying data source is a DataSet, DataTable, or DataView, this method calls the DataView.IBindingList.Find method. Zachowanie IBindingList.Find , takie jak wartość zwracana, jeśli nie znaleziono pasującego elementu, zależy od implementacji metody na liście podstawowej.The behavior of IBindingList.Find, such as the value returned if no matching item is found, depends on the implementation of the method in the underlying list.

Zobacz też

Dotyczy

Find(String, Object)

Zwraca indeks elementu na liście z określoną nazwą właściwości i wartością.Returns the index of the item in the list with the specified property name and value.

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.The name of the property to search for.

key
Object

Wartość elementu z określonym propertyName do znalezienia.The value of the item with the specified propertyName to find.

Zwraca

Int32

Indeks (liczony od zera) elementu z określoną nazwą właściwości i wartością.The zero-based index of the item with the specified property name and value.

Wyjątki

Podstawowa lista nie jest IBindingList zaimplementowaną funkcją wyszukiwania.The underlying list is not a IBindingList with searching functionality implemented.

propertyName nie pasuje do właściwości na liście.propertyName does not match a property in the list.

Przykłady

Poniższy przykład pokazuje, jak używać Find metody z DataView .The following example shows how to use the Find method with a DataView. Aby uruchomić ten przykład, wklej kod do formularza systemu Windows i Wywołaj PopulateDataViewAndFind z konstruktora formularza lub Load metody obsługi zdarzeń.To run this example, paste the code into a Windows Form and call PopulateDataViewAndFind from the form's constructor or Load event-handling method. Formularz powinien importować System.Xml System.IO przestrzenie nazw i.Your form should import the System.Xml and System.IO namespaces.

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&amp;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&amp;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

FindMetody można używać tylko wtedy, gdy podstawową listą jest obiekt IBindingList z zaimplementowanym wyszukiwaniem.The Find method can only be used when the underlying list is an IBindingList with searching implemented. Ta metoda po prostu przywołuje żądanie do metody podstawowej listy IBindingList.Find .This method simply refers the request to the underlying list's IBindingList.Find method. Na przykład, jeśli źródłowe źródło danych jest DataSet , DataTable , lub DataView , ta metoda jest konwertowana propertyName na a PropertyDescriptor i wywołuje IBindingList.Find metodę.For example, if the underlying data source is a DataSet, DataTable, or DataView, this method converts propertyName to a PropertyDescriptor and calls the IBindingList.Find method. Zachowanie Find , takie jak wartość zwracana, jeśli nie znaleziono pasującego elementu, zależy od implementacji metody na liście podstawowej.The behavior of Find, such as the value returned if no matching item is found, depends on the implementation of the method in the underlying list.

W porównaniu z nazwą właściwości nie jest rozróżniana wielkość liter.The property name comparison is case-insensitive.

Dotyczy