IBindingList.Find(PropertyDescriptor, Object) 方法

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

返回具有给定 PropertyDescriptor 的行的索引。

public:
 int Find(System::ComponentModel::PropertyDescriptor ^ property, System::Object ^ key);

public int Find (System.ComponentModel.PropertyDescriptor property, object key);

abstract member Find : System.ComponentModel.PropertyDescriptor * obj -> int

Public Function Find (property As PropertyDescriptor, key As Object) As Integer

参数

property

PropertyDescriptor

要对其进行搜索的 PropertyDescriptor。

key

Object

要搜索的 property 参数的值。

返回

Int32

具有给定 PropertyDescriptor 的行的索引。

例外

NotSupportedException

SupportsSearching 为 false。

示例

下面的代码示例演示如何实现 Find 方法。

    public class MyFontList : BindingList<Font>
    {

        protected override bool SupportsSearchingCore
        {
            get { return true; }
        }
        protected override int FindCore(PropertyDescriptor prop, object key)
        {
            // Ignore the prop value and search by family name.
            for (int i = 0; i < Count; ++i)
            {
                if (Items[i].FontFamily.Name.ToLower() == ((string)key).ToLower())
                    return i;
            }
            return -1;
        }
    }
}

Public Class MyFontList
    Inherits BindingList(Of Font)

    Protected Overrides ReadOnly Property SupportsSearchingCore() As Boolean
        Get
            Return True
        End Get
    End Property
    
    Protected Overrides Function FindCore(ByVal prop As PropertyDescriptor, _
        ByVal key As Object) As Integer
        ' Ignore the prop value and search by family name.
        Dim i As Integer
        While i < Count
            If Items(i).FontFamily.Name.ToLower() = CStr(key).ToLower() Then
                Return i
            End If
            i += 1
        End While

        Return -1
    End Function
End Class

注解

此方法将选择参数值等于参数值propertykey的第一行。

如果 SupportsSearching 为 true，则支持此方法，否则此方法将 NotSupportedException引发 。