BindingSource.Find Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Busca el elemento especificado en el origen de datos.

Sobrecargas

Find(PropertyDescriptor, Object)	Busca el índice del elemento que tiene el descriptor de propiedad especificado.
Find(String, Object)	Devuelve el índice del elemento de la lista con el nombre y el valor de propiedad especificados.

Find(PropertyDescriptor, Object)

Busca el índice del elemento que tiene el descriptor de propiedad especificado.

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

Parámetros

prop

PropertyDescriptor

PropertyDescriptor que se va a buscar.

key

Object

Valor de prop que debe coincidir.

Devoluciones

Int32

El índice de base cero del elemento que tiene el valor especificado para PropertyDescriptor.

Implementaciones

Find(PropertyDescriptor, Object)

Excepciones

NotSupportedException

La lista subyacente no es de tipo IBindingList.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método Find. Para obtener el ejemplo completo, consulte el tema de información general de la clase.

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

Comentarios

Este método se usa normalmente en casos complejos de enlace de datos para buscar la primera fila donde el valor del campo especificado por el prop parámetro es igual al valor del key parámetro.

Este método simplemente hace referencia a la solicitud al método de IBindingList.Find la lista subyacente. Por ejemplo, si el origen de datos subyacente es , DataSetDataTableo DataView, este método llama al DataView.IBindingList.Find método . El comportamiento de IBindingList.Find, como el valor devuelto si no se encuentra ningún elemento coincidente, depende de la implementación del método en la lista subyacente.

Consulte también

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

Find(String, Object)

Devuelve el índice del elemento de la lista con el nombre y el valor de propiedad especificados.

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

Parámetros

propertyName

String

Nombre de la propiedad que se va a buscar.

key

Object

El valor del elemento con el nombre de propiedad propertyName que buscar.

Devoluciones

Int32

El índice de base cero del elemento con el nombre y el valor de propiedad especificados.

Excepciones

InvalidOperationException

La lista subyacente no es una IBindingList con funcionalidad de búsqueda implementada.

ArgumentException

propertyName no coincide con ninguna propiedad de la lista.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Find método con .DataView Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame PopulateDataViewAndFind desde el constructor o Load el método de control de eventos del formulario. El formulario debe importar los System.Xml espacios de nombres y 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

Comentarios

El Find método solo se puede usar cuando la lista subyacente es una IBindingList clase con la búsqueda implementada. Este método simplemente hace referencia a la solicitud al método de IBindingList.Find la lista subyacente. Por ejemplo, si el origen de datos subyacente es , DataSetDataTableo DataView, este método se propertyName convierte en y PropertyDescriptor llama al IBindingList.Find método . El comportamiento de Find, como el valor devuelto si no se encuentra ningún elemento coincidente, depende de la implementación del método en la lista subyacente.

La comparación de nombres de propiedad no distingue mayúsculas de minúsculas.