BindingSource.Find Metod

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

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

Parametrar

Returer

Det nollbaserade indexet för objektet som har det angivna värdet för PropertyDescriptor.

Implementeringar

Undantag

Exempel

I följande kodexempel visas hur du använder Find metoden. Det fullständiga exemplet finns i avsnittet klassöversikt.

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

Kommentarer

Den här metoden används vanligtvis i komplexa databindningsfall för att hitta den första raden där värdet för fältet som anges av parametern prop är lika med värdet för parametern key

Den här metoden refererar helt enkelt begäran till den underliggande listans IBindingList.Find metod. Om den underliggande datakällan till exempel är en DataSet, DataTableeller DataView, anropar DataView.IBindingList.Find den här metoden metoden. Beteendet IBindingList.Findför , till exempel det värde som returneras om inget matchande objekt hittas, beror på implementeringen av metoden i den underliggande listan.

Se även

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

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

Källa:

BindingSource.cs

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

Parametrar

Returer

Det nollbaserade indexet för objektet med det angivna egenskapsnamnet och värdet.

Undantag

Exempel

I följande exempel visas hur du använder Find metoden med en DataView. Om du vill köra det här exemplet klistrar du in koden i ett Windows formulär och anropar PopulateDataViewAndFind från formulärets konstruktor eller Load händelsehanteringsmetod. Formuläret ska importera namnrymderna System.Xml och 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

Kommentarer

Metoden Find kan bara användas när den underliggande listan är en IBindingList med sökning implementerad. Den här metoden refererar helt enkelt begäran till den underliggande listans IBindingList.Find metod. Om den underliggande datakällan till exempel är en DataSet, DataTableeller DataView, konverterar den här metoden till en propertyName och anropar PropertyDescriptorIBindingList.Find metoden. Beteendet Findför , till exempel det värde som returneras om inget matchande objekt hittas, beror på implementeringen av metoden i den underliggande listan.

Jämförelsen av egenskapsnamn är skiftlägeskänslig.