BindingSource.Find BindingSource.Find BindingSource.Find BindingSource.Find Method

Définition

Recherche l'élément spécifié dans la source de données.Find the specified item in the data source.

Surcharges

Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object)

Recherche l'index de l'élément qui a le descripteur de propriété donné.Searches for the index of the item that has the given property descriptor.

Find(String, Object) Find(String, Object) Find(String, Object) Find(String, Object)

Retourne l'index de l'élément dans la liste avec le nom et la valeur de propriété spécifiés.Returns the index of the item in the list with the specified property name and value.

Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object)

Recherche l'index de l'élément qui a le descripteur de propriété donné.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

Paramètres

key
Object Object Object Object

Valeur de prop à atteindre.The value of prop to match.

Retours

Index de base zéro de l'élément qui a la valeur donnée pour PropertyDescriptor.The zero-based index of the item that has the given value for PropertyDescriptor.

Implémente

Exceptions

La liste sous-jacente n'est pas de type IBindingList.The underlying list is not of type IBindingList.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode Find.The following code example demonstrates how to use the Find method. Pour obtenir un exemple complet, consultez la rubrique vue d’ensemble de la classe.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

Remarques

Cette méthode est généralement utilisée dans les cas de liaison de données complexes pour localiser la première ligne où la valeur du champ spécifié par prop le paramètre est égale à la valeur key du paramètre.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

Cette méthode fait simplement référence à la requête à la méthode IBindingList.Find de la liste sous-jacente.This method simply refers the request to the underlying list's IBindingList.Find method. Par exemple, si la source de données sous- DataSetjacente DataTableest, DataViewou, cette méthode appelle DataView.IBindingList.Find la méthode.For example, if the underlying data source is a DataSet, DataTable, or DataView, this method calls the DataView.IBindingList.Find method. Le comportement de IBindingList.Find, tel que la valeur retournée si aucun élément correspondant n’est trouvé, dépend de l’implémentation de la méthode dans la liste sous-jacente.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.

Voir aussi

Find(String, Object) Find(String, Object) Find(String, Object) Find(String, Object)

Retourne l'index de l'élément dans la liste avec le nom et la valeur de propriété spécifiés.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

Paramètres

propertyName
String String String String

Nom de la propriété à rechercher.The name of the property to search for.

key
Object Object Object Object

Valeur de l'élément avec le propertyName spécifié à rechercher.The value of the item with the specified propertyName to find.

Retours

Index de base zéro de l'élément avec le nom et la valeur de propriété spécifiés.The zero-based index of the item with the specified property name and value.

Exceptions

La liste sous-jacente n'est pas un IBindingList sur laquelle sont implémentées des fonctionnalités de recherche.The underlying list is not a IBindingList with searching functionality implemented.

propertyName ne correspond pas à une propriété de la liste.propertyName does not match a property in the list.

Exemples

L’exemple suivant montre comment utiliser la Find méthode avec un. DataViewThe following example shows how to use the Find method with a DataView. Pour exécuter cet exemple, collez le code dans un Windows Form et PopulateDataViewAndFind appelez à partir du constructeur du Load formulaire ou de la méthode de gestion d’événements.To run this example, paste the code into a Windows Form and call PopulateDataViewAndFind from the form's constructor or Load event-handling method. Votre formulaire doit importer les System.Xml espaces System.IO de noms et.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

Remarques

La Find méthode ne peut être utilisée que si la liste sous- IBindingList jacente est un avec une recherche implémentée.The Find method can only be used when the underlying list is an IBindingList with searching implemented. Cette méthode fait simplement référence à la requête à la méthode IBindingList.Find de la liste sous-jacente.This method simply refers the request to the underlying list's IBindingList.Find method. Par exemple, si la source de données sous- DataSetjacente DataTableest, DataViewou, cette méthode convertit PropertyDescriptor propertyName en et appelle IBindingList.Find la méthode.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. Le comportement de Find, tel que la valeur retournée si aucun élément correspondant n’est trouvé, dépend de l’implémentation de la méthode dans la liste sous-jacente.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.

La comparaison du nom de la propriété n’est pas sensible à la casse.The property name comparison is case-insensitive.

S’applique à