ITypedList インターフェイス


バインドに利用できるプロパティがバインド先のオブジェクトのパブリック プロパティと異なる場合に、バインド可能リストのスキーマを検出できるようにします。Provides functionality to discover the schema for a bindable list, where the properties available for binding differ from the public properties of the object to bind to.

public interface class ITypedList
public interface ITypedList
type ITypedList = interface
Public Interface ITypedList

次のコード例は、ITypedList インターフェイスを実装する方法を示しています。The following code example demonstrates how to implement the ITypedList interface. SortableBindingList という名前のジェネリック型は、BindingList<T> クラスから派生し、ITypedList インターフェイスを実装します。A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList interface. 完全なコードリストについては、「方法: ITypedList インターフェイスを実装する」を参照してください。For a full code listing, see How to: Implement the ITypedList Interface.

using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.Windows.Forms;
using System.Collections;
using System.Reflection;

namespace ITypedListCS
    public class SortableBindingList<T> : BindingList<T>, ITypedList
        private PropertyDescriptorCollection properties;

        public SortableBindingList() : base()
            // Get the 'shape' of the list. 
            // Only get the public properties marked with Browsable = true.
            PropertyDescriptorCollection pdc = TypeDescriptor.GetProperties(
                new Attribute[] { new BrowsableAttribute(true) });

            // Sort the properties.
            properties = pdc.Sort();

        #region ITypedList Implementation

        public PropertyDescriptorCollection GetItemProperties(PropertyDescriptor[] listAccessors)
            PropertyDescriptorCollection pdc;

            if (listAccessors!=null && listAccessors.Length>0)
                // Return child list shape.
                pdc = ListBindingHelper.GetListItemProperties(listAccessors[0].PropertyType);
                // Return properties in sort order.
                pdc = properties;

            return pdc;

        // This method is only used in the design-time framework 
        // and by the obsolete DataGrid control.
        public string GetListName(PropertyDescriptor[] listAccessors)
            return typeof(T).Name;

Imports System.ComponentModel
Imports System.Collections.Generic
Imports System.Windows.Forms

<Serializable()> _
Public Class SortableBindingList(Of Tkey)
    Inherits BindingList(Of Tkey)
    Implements ITypedList

    <NonSerialized()> _
    Private properties As PropertyDescriptorCollection

    Public Sub New()

        ' Get the 'shape' of the list. 
        ' Only get the public properties marked with Browsable = true.
        Dim pdc As PropertyDescriptorCollection = TypeDescriptor.GetProperties(GetType(Tkey), New Attribute() {New BrowsableAttribute(True)})

        ' Sort the properties.
        properties = pdc.Sort()

    End Sub

#Region "ITypedList Implementation"

    Public Function GetItemProperties(ByVal listAccessors() As System.ComponentModel.PropertyDescriptor) As System.ComponentModel.PropertyDescriptorCollection Implements System.ComponentModel.ITypedList.GetItemProperties

        Dim pdc As PropertyDescriptorCollection

        If (Not (listAccessors Is Nothing)) And (listAccessors.Length > 0) Then
            ' Return child list shape
            pdc = ListBindingHelper.GetListItemProperties(listAccessors(0).PropertyType)
            ' Return properties in sort order
            pdc = properties
        End If

        Return pdc

    End Function

    ' This method is only used in the design-time framework 
    ' and by the obsolete DataGrid control.
    Public Function GetListName( _
    ByVal listAccessors() As PropertyDescriptor) As String _
    Implements System.ComponentModel.ITypedList.GetListName

        Return GetType(Tkey).Name

    End Function

#End Region

End Class


たとえば、customer テーブルを表す DataView オブジェクトを使用している場合、このインターフェイスは、DataViewのプロパティではなく、DataView が表す customer オブジェクトのプロパティにバインドする場合に使用します。Use this interface if, for instance, you are using a DataView object that represents a customer table, you want to bind to the properties on the customer object that the DataView represents, not the properties of the DataView.

このインターフェイスは、バインド可能なリストをデザイン時にサポートするためには必要ありません。This interface is not required for design-time support of a bindable list.

データへのバインドは、実行時またはデザイナーで行うことができますが、両方に対する規則があります。Binding to data can occur either at run time or in a designer, but there are rules for both. 実行時には、次のいずれかのデータにバインドできます。At run time, you can bind to data in any of the following:

  • Array

  • IListの実装者は、厳密に型指定された Item[] プロパティを実装していることを示しています (つまり、Type はすべてが Object)。Implementer of IList, provided the implementer has a strongly typed Item[] property (that is, the Type is anything but Object). これを実現するには、Item[] private の既定の実装を作成します。You can accomplish this by making the default implementation of Item[] private. 厳密に型指定されたコレクションの規則に従う IList を作成する場合は、CollectionBaseから派生させる必要があります。If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • ITypedListの実装者。Implementer of ITypedList.

デザイナーでは、同じ規則に従って Component オブジェクトへのバインドを初期化できます。In a designer, you can initialize binding to Component objects by following the same rules.

データソースへのバインドの詳細については、System.Windows.Forms.Binding クラスを参照してください。For more information on binding to a data source, see the System.Windows.Forms.Binding class.



データ バインドに使用される各項目のプロパティを表す PropertyDescriptorCollection を返します。Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.


リストの名前を返します。Returns the name of the list.