BindingList.FindCore メソッド

.NET Framework クラス ライブラリ リファレンス

BindingList.FindCore メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

検索が派生クラスに実装されている場合、指定した値の指定したプロパティ記述子を持つ項目のインデックスを検索します。実装されていない場合は NotSupportedException がスローされます。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 FindCore ( _
    prop As PropertyDescriptor, _
    key As Object _
) As Integer

Visual Basic (使用法)

Dim prop As PropertyDescriptor
Dim key As Object
Dim returnValue As Integer

returnValue = Me.FindCore(prop, key)

C#

protected virtual int FindCore (
    PropertyDescriptor prop,
    Object key
)

C++

protected:
virtual int FindCore (
    PropertyDescriptor^ prop, 
    Object^ key
)

J#

protected int FindCore (
    PropertyDescriptor prop, 
    Object key
)

JScript

protected function FindCore (
    prop : PropertyDescriptor, 
    key : Object
) : int

パラメータ

prop

検索対象の PropertyDescriptor。

key

検索条件として使用する property の値。

戻り値
プロパティ記述子に一致し、指定した値を格納している項目の 0 から始まるインデックス。

例外

例外の種類	条件
NotSupportedException	FindCore は、派生クラスでオーバーライドされません。

解説

BindingList クラスは検索の基本実装を提供していないため、既定では、FindCore は常に NotSupportedException をスローします。検索を有効にするには、BindingList から派生して、次のタスクを実行します。

• SupportsSearchingCore をオーバーライドし、SupportsSearchingCore プロパティを true に設定します。

• FindCore をオーバーライドし、検索アルゴリズムを実装します。

使用例

FindCore メンバの使用方法を次のコード例に示します。

Visual Basic

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

C#

    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;
        }


    }
  
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
BindingList ジェネリック クラス
BindingList メンバ
System.ComponentModel 名前空間