BindingSource.Find Methode

Definition

Sucht das angegebene Element in der Datenquelle.Find the specified item in the data source.

Überlädt

Find(PropertyDescriptor, Object)

Sucht nach dem Index des Elements, das den angegebenen Eigenschaftenbezeichner hat.Searches for the index of the item that has the given property descriptor.

Find(String, Object)

Gibt den Index des Elements in der Liste mit dem angegebenen Eigenschaftennamen und Eigenschaftswert zurück.Returns the index of the item in the list with the specified property name and value.

Find(PropertyDescriptor, Object)

Sucht nach dem Index des Elements, das den angegebenen Eigenschaftenbezeichner hat.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

Parameter

prop
PropertyDescriptor

Die zu suchende PropertyDescriptor.The PropertyDescriptor to search for.

key
Object

Der Wert von prop, der übereinstimmen soll.The value of prop to match.

Gibt zurück

Der nullbasierte Index des Elements, das für PropertyDescriptor den angegebenen Wert hat.The zero-based index of the item that has the given value for PropertyDescriptor.

Implementiert

Ausnahmen

Die zugrunde liegende Liste ist nicht vom Typ IBindingList.The underlying list is not of type IBindingList.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Find-Methode verwenden.The following code example demonstrates how to use the Find method. Das komplette Beispiel finden Sie im Thema Übersicht über die Klasse.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

Hinweise

Diese Methode wird in der Regel in komplexen Daten Bindungs Fällen verwendet, um die erste Zeile zu suchen, in der der Wert des Felds, das vom prop-Parameter angegeben wird, dem Wert des key-Parameters entspricht.This 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

Mit dieser Methode wird die Anforderung einfach auf die IBindingList.Find Methode der zugrunde liegenden Liste verwiesen.This method simply refers the request to the underlying list's IBindingList.Find method. Wenn die zugrunde liegende Datenquelle z. b. eine DataSet, DataTableoder DataViewist, ruft diese Methode die DataView.IBindingList.Find-Methode auf.For example, if the underlying data source is a DataSet, DataTable, or DataView, this method calls the DataView.IBindingList.Find method. Das Verhalten von IBindingList.Find, z. b. der zurückgegebene Wert, wenn kein übereinstimmendes Element gefunden wird, hängt von der Implementierung der-Methode in der zugrunde liegenden Liste ab.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.

Siehe auch

Find(String, Object)

Gibt den Index des Elements in der Liste mit dem angegebenen Eigenschaftennamen und Eigenschaftswert zurück.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

Parameter

propertyName
String

Der Name der Eigenschaft, nach der gesucht werden soll.The name of the property to search for.

key
Object

Der Wert des zu suchenden Elements mit dem angegebenen propertyName.The value of the item with the specified propertyName to find.

Gibt zurück

Der nullbasierte Index des Elements mit dem angegebenen Eigenschaftennamen und dem angegebenen Eigenschaftswert.The zero-based index of the item with the specified property name and value.

Ausnahmen

Die zugrunde liegende Liste ist keine IBindingList mit implementierter Suchfunktion.The underlying list is not a IBindingList with searching functionality implemented.

propertyName stimmt mit keiner Eigenschaft in der Liste überein.propertyName does not match a property in the list.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Find-Methode mit einem DataViewverwendet wird.The following example shows how to use the Find method with a DataView. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form ein, und nennen Sie PopulateDataViewAndFind aus dem Konstruktor des Formulars oder Load Ereignis Behandlungsmethode.To run this example, paste the code into a Windows Form and call PopulateDataViewAndFind from the form's constructor or Load event-handling method. Das Formular sollte die System.Xml-und System.IO-Namespaces importieren.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

Hinweise

Die Find-Methode kann nur verwendet werden, wenn die zugrunde liegende Liste eine IBindingList ist, bei der die Suche implementiert ist.The Find method can only be used when the underlying list is an IBindingList with searching implemented. Mit dieser Methode wird die Anforderung einfach auf die IBindingList.Find Methode der zugrunde liegenden Liste verwiesen.This method simply refers the request to the underlying list's IBindingList.Find method. Wenn die zugrunde liegende Datenquelle z. b. eine DataSet, DataTableoder DataViewist, konvertiert diese Methode propertyName in eine PropertyDescriptor und ruft die IBindingList.Find-Methode auf.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. Das Verhalten von Find, z. b. der zurückgegebene Wert, wenn kein übereinstimmendes Element gefunden wird, hängt von der Implementierung der-Methode in der zugrunde liegenden Liste ab.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.

Beim Vergleich von Eigenschaften Namen wird die Groß-/Kleinschreibung nicht beachtetThe property name comparison is case-insensitive.

Gilt für: