BindingSource.Find Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Veri kaynağında belirtilen öğeyi bulun.

Aşırı Yüklemeler

Find(PropertyDescriptor, Object)	Verilen özellik tanımlayıcısı olan öğenin dizinini arar.
Find(String, Object)	Belirtilen özellik adı ve değeriyle listedeki öğenin dizinini döndürür.

Find(PropertyDescriptor, Object)

Verilen özellik tanımlayıcısı olan öğenin dizinini arar.

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

Parametreler

prop

PropertyDescriptor

PropertyDescriptor Aranacak.

key

Object

Eşleştirecek değeri prop .

Döndürülenler

Int32

için PropertyDescriptorverilen değere sahip öğenin sıfır tabanlı dizini.

Uygulamalar

Find(PropertyDescriptor, Object)

Özel durumlar

NotSupportedException

Temel alınan liste türünde IBindingListdeğil.

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir Find . Tam örnek için sınıfa genel bakış konusuna bakın.

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

Açıklamalar

Bu yöntem genellikle karmaşık veri bağlama durumlarında parametre tarafından prop belirtilen alanın değerinin parametrenin değerine key eşit olduğu ilk satırı bulmak için kullanılır

Bu yöntem yalnızca isteği temel alınan listenin IBindingList.Find yöntemine başvurur. Örneğin, temel alınan veri kaynağı bir DataSet, DataTableveya DataViewise, bu yöntem yöntemini çağırır DataView.IBindingList.Find . eşleşen öğe bulunamazsa döndürülen değer gibi öğesinin davranışı IBindingList.Find, temel alınan listedeki yöntemin uygulanmasına bağlıdır.

Ayrıca bkz.

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

Find(String, Object)

Belirtilen özellik adı ve değeriyle listedeki öğenin dizinini döndürür.

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

Parametreler

propertyName

String

Aranacak özelliğin adı.

key

Object

Öğesinin bulunacak belirtilen propertyName değeri.

Döndürülenler

Int32

Belirtilen özellik adına ve değerine sahip öğenin sıfır tabanlı dizini.

Özel durumlar

InvalidOperationException

Temel alınan liste, uygulanan arama işlevine sahip bir IBindingList liste değildir.

ArgumentException

propertyName listedeki bir özellikle eşleşmiyor.

Örnekler

Aşağıdaki örnekte yönteminin Find ile DataViewnasıl kullanılacağı gösterilmektedir. Bu örneği çalıştırmak için, kodu bir Windows Formuna yapıştırın ve formun oluşturucusundan veya Load olay işleme yönteminden çağırınPopulateDataViewAndFind. Formunuzun ve System.IO ad alanlarını içeri aktarması System.Xml gerekir.

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

Açıklamalar

Find yöntemi yalnızca temel alınan liste, arama uygulanan bir IBindingList olduğunda kullanılabilir. Bu yöntem yalnızca isteği temel alınan listenin IBindingList.Find yöntemine başvurur. Örneğin, temel alınan veri kaynağı bir DataSet, DataTableveya DataViewise, bu yöntem öğesine PropertyDescriptor dönüştürülür propertyName ve yöntemini çağırırIBindingList.Find. eşleşen öğe bulunamazsa döndürülen değer gibi öğesinin davranışı Find, temel alınan listedeki yöntemin uygulanmasına bağlıdır.

Özellik adı karşılaştırması büyük/küçük harfe duyarlı değildir.