BindingSource.Find Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Recherche l'élément spécifié dans la source de données.

Surcharges

Find(PropertyDescriptor, Object)	Recherche l'index de l'élément qui a le descripteur de propriété donné.
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.

Find(PropertyDescriptor, Object)

Source:

BindingSource.cs

Recherche l'index de l'élément qui a le descripteur de propriété donné.

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

prop

PropertyDescriptor

PropertyDescriptor à rechercher.

key

Object

Valeur de prop à atteindre.

Retours

Int32

Index de base zéro de l'élément qui a la valeur donnée pour PropertyDescriptor.

Implémente

Find(PropertyDescriptor, Object)

Exceptions

NotSupportedException

La liste sous-jacente n'est pas de type IBindingList.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode Find. Pour obtenir l’exemple complet, consultez la rubrique Vue d’ensemble de la classe.

private void button1_Click(object sender, EventArgs e)
{
    if (!binding1.SupportsSearching)
    {
        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 complexes de liaison de données pour localiser la première ligne où la valeur du champ spécifié par le prop paramètre est égale à la valeur du key paramètre

Cette méthode fait simplement référence à la requête à la méthode de IBindingList.Find la liste sous-jacente. Par exemple, si la source de données sous-jacente est un DataSet, DataTableou DataView, cette méthode appelle la DataView.IBindingList.Find méthode . 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.

Voir aussi

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

Find(String, Object)

Source:

BindingSource.cs

Retourne l'index de l'élément dans la liste avec le nom et la valeur de propriété spécifiés.

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

Nom de la propriété à rechercher.

key

Object

Valeur de l'élément avec le propertyName spécifié à rechercher.

Retours

Int32

Index de base zéro de l'élément avec le nom et la valeur de propriété spécifiés.

Exceptions

InvalidOperationException

La liste sous-jacente n'est pas un IBindingList sur laquelle sont implémentées des fonctionnalités de recherche.

ArgumentException

propertyName ne correspond pas à une propriété de la liste.

Exemples

L’exemple suivant montre comment utiliser la Find méthode avec un DataView. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez PopulateDataViewAndFind à partir du constructeur ou Load de la méthode de gestion des événements du formulaire. Votre formulaire doit importer les espaces de System.Xml noms et .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

Remarques

La Find méthode ne peut être utilisée que lorsque la liste sous-jacente est une IBindingList avec recherche implémentée. Cette méthode fait simplement référence à la requête à la méthode de IBindingList.Find la liste sous-jacente. Par exemple, si la source de données sous-jacente est un DataSet, DataTableou DataView, cette méthode convertit propertyName en et PropertyDescriptor appelle la IBindingList.Find méthode . 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.

La comparaison des noms de propriété ne respecte pas la casse.