BindingSource.Find Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Sucht das angegebene Element in der Datenquelle.

Überlädt

Find(PropertyDescriptor, Object)	Sucht nach dem Index des Elements, das den angegebenen Eigenschaftenbezeichner hat.
Find(String, Object)	Gibt den Index des Elements in der Liste mit dem angegebenen Eigenschaftennamen und Eigenschaftswert zurück.

Find(PropertyDescriptor, Object)

Sucht nach dem Index des Elements, das den angegebenen Eigenschaftenbezeichner hat.

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.

key

Object

Der Wert von prop, der übereinstimmen soll.

Gibt zurück

Int32

Der nullbasierte Index des Elements, das für PropertyDescriptor den angegebenen Wert hat.

Implementiert

Find(PropertyDescriptor, Object)

Ausnahmen

NotSupportedException

Die zugrunde liegende Liste ist nicht vom Typ IBindingList.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Find-Methode verwenden. Das vollständige Beispiel finden Sie im Thema Klassenübersicht.

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 Datenbindungsfällen verwendet, um die erste Zeile zu suchen, in der der Wert des durch den prop Parameter angegebenen Felds dem Wert des key Parameters entspricht.

Diese Methode verweist die Anforderung einfach auf die -Methode der zugrunde liegenden Liste IBindingList.Find . Wenn die zugrunde liegende Datenquelle beispielsweise ein DataSet, DataTableoder DataViewist, ruft diese Methode die -Methode auf DataView.IBindingList.Find . Das Verhalten von IBindingList.Find, z. B. der wert, der zurückgegeben wird, wenn kein übereinstimmende Element gefunden wird, hängt von der Implementierung der -Methode in der zugrunde liegenden Liste ab.

Weitere Informationen

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

Find(String, Object)

Gibt den Index des Elements in der Liste mit dem angegebenen Eigenschaftennamen und Eigenschaftswert zurück.

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.

key

Object

Der Wert des zu suchenden Elements mit dem angegebenen propertyName.

Gibt zurück

Int32

Der nullbasierte Index des Elements mit dem angegebenen Eigenschaftennamen und dem angegebenen Eigenschaftswert.

Ausnahmen

InvalidOperationException

Die zugrunde liegende Liste ist keine IBindingList mit implementierter Suchfunktion.

ArgumentException

propertyName stimmt mit keiner Eigenschaft in der Liste überein.

Beispiele

Das folgende Beispiel zeigt, wie die Find -Methode mit einem DataViewverwendet wird. Um dieses Beispiel auszuführen, fügen Sie den Code in eine Windows Form ein, und rufen PopulateDataViewAndFind Sie aus dem Konstruktor oder Load der Ereignisbehandlungsmethode des Formulars auf. Ihr Formular sollte die System.Xml Namespaces und System.IO importieren.

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

Hinweise

Die Find -Methode kann nur verwendet werden, wenn es sich bei der zugrunde liegenden Liste um eine mit implementierter IBindingList Suche handelt. Diese Methode verweist die Anforderung einfach auf die -Methode der zugrunde liegenden Liste IBindingList.Find . Wenn die zugrunde liegende Datenquelle beispielsweise ein DataSet, DataTableoder DataViewist, konvertiert propertyName diese Methode in eine PropertyDescriptor und ruft die IBindingList.Find -Methode auf. Das Verhalten von Find, z. B. der wert, der zurückgegeben wird, wenn kein übereinstimmende Element gefunden wird, hängt von der Implementierung der -Methode in der zugrunde liegenden Liste ab.

Beim Vergleich des Eigenschaftsnamens wird die Groß-/Kleinschreibung nicht beachtet.