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

Definición

Busca el elemento especificado en el origen de datos.Find the specified item in the data source.

Sobrecargas

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

Busca el índice del elemento que tiene el descriptor de propiedad especificado.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)

Devuelve el índice del elemento de la lista con el nombre y el valor de propiedad especificados.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)

Busca el índice del elemento que tiene el descriptor de propiedad especificado.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

Parámetros

key
Object Object Object Object

El valor de prop para hacer coincidir.The value of prop to match.

Devoluciones

Índice de base cero del elemento que tiene el valor especificado para PropertyDescriptor.The zero-based index of the item that has the given value for PropertyDescriptor.

Implementaciones

Excepciones

La lista subyacente no es de tipo IBindingList.The underlying list is not of type IBindingList.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método Find.The following code example demonstrates how to use the Find method. Para obtener un ejemplo completo, vea el tema de información general sobre la clase.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

Comentarios

Este método se utiliza normalmente en casos de enlace de datos complejos para buscar la primera fila donde el valor del campo especificado por el prop parámetro es igual al valor de la key parámetroThis 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

Este método simplemente hace referencia a la solicitud a la lista subyacente IBindingList.Find método.This method simply refers the request to the underlying list's IBindingList.Find method. Por ejemplo, si el origen de datos subyacente es un DataSet, DataTable, o DataView, este método llama a la DataView.IBindingList.Find método.For example, if the underlying data source is a DataSet, DataTable, or DataView, this method calls the DataView.IBindingList.Find method. 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.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.

Consulte también:

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

Devuelve el índice del elemento de la lista con el nombre y el valor de propiedad especificados.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

Parámetros

propertyName
String String String String

Nombre de la propiedad que se va a buscar.The name of the property to search for.

key
Object Object Object Object

El valor del elemento con los valores especificados de propertyName para buscar.The value of the item with the specified propertyName to find.

Devoluciones

Índice de base cero del elemento con el nombre de propiedad especificado y el valor.The zero-based index of the item with the specified property name and value.

Excepciones

La lista subyacente no es un IBindingList con funcionalidad de búsqueda implementada.The underlying list is not a IBindingList with searching functionality implemented.

propertyName no coincide con una propiedad en la lista.propertyName does not match a property in the list.

Ejemplos

El ejemplo siguiente muestra cómo usar el Find método con un DataView.The following example shows how to use the Find method with a DataView. Para ejecutar este ejemplo, pegue el código en un formulario de Windows y la llamada PopulateDataViewAndFind desde el constructor del formulario o Load el método de control de eventos.To run this example, paste the code into a Windows Form and call PopulateDataViewAndFind from the form's constructor or Load event-handling method. El formulario debe importar el System.Xml y System.IO espacios de nombres.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

Comentarios

El Find método sólo se puede utilizar cuando la lista subyacente es un IBindingList con búsqueda implementada.The Find method can only be used when the underlying list is an IBindingList with searching implemented. Este método simplemente hace referencia a la solicitud a la lista subyacente IBindingList.Find método.This method simply refers the request to the underlying list's IBindingList.Find method. Por ejemplo, si el origen de datos subyacente es un DataSet, DataTable, o DataView, este método convierte propertyName a un PropertyDescriptor y llama a la IBindingList.Find método.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. 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.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 comparación de nombres de propiedad distingue mayúsculas de minúsculas.The property name comparison is case-insensitive.

Se aplica a