ITypedList Interface

Définition

public interface class ITypedList

public interface ITypedList

type ITypedList = interface

Public Interface ITypedList

Dérivé

System.Data.DataView

System.Data.DataViewManager

System.Web.UI.WebControls.ListViewPagedDataSource

System.Web.UI.WebControls.PagedDataSource

System.Windows.Forms.BindingSource

Exemples

L’exemple de code suivant montre comment implémenter l’interface ITypedList. Un type générique nommé SortableBindingList dérive de la BindingList<T> classe et implémente l’interface ITypedList . Pour obtenir une description complète du code, consultez Guide pratique pour implémenter l’interface ITypedList.

using System;
using System.ComponentModel;
using System.Windows.Forms;

namespace ITypedListCS;

[Serializable()]
public class SortableBindingList<T> : BindingList<T>, ITypedList
{
    [NonSerialized()]
    readonly PropertyDescriptorCollection properties;

    public SortableBindingList() : base()
    {
        // Get the 'shape' of the list. 
        // Only get the public properties marked with Browsable = true.
        PropertyDescriptorCollection pdc = TypeDescriptor.GetProperties(
            typeof(T),
            [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);
        }
        else
        {
            // 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) => typeof(T).Name;

    #endregion
}

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()
        MyBase.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)
        Else
            ' 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

Remarques

Utilisez cette interface si, par exemple, vous utilisez un objet qui représente une DataViewcustomer table, que vous souhaitez lier aux propriétés de l’objet customer que représente DataView , et non aux propriétés de l’objet DataView.

Cette interface n’est pas nécessaire pour la prise en charge au moment du design d’une liste pouvant être liée.

La liaison aux données peut se produire au moment de l’exécution ou dans un concepteur, mais il existe des règles pour les deux. Au moment de l’exécution, vous pouvez lier des données dans l’une des opérations suivantes :

• Array

• Implémenteur de IList, à condition que l’implémenteur dispose d’une propriété fortement typée Item[] (autrement dit, c’est Type tout sauf Object). Pour ce faire, vous pouvez effectuer l’implémentation par défaut de Item[] private. Si vous souhaitez créer un IList qui suit les règles d’une collection fortement typée, vous devez dériver de CollectionBase.

• Implémenteur de ITypedList.

Dans un concepteur, vous pouvez initialiser la liaison à des Component objets en suivant les mêmes règles.

Pour plus d’informations sur la liaison à une source de données, consultez la System.Windows.Forms.Binding classe.

Voir aussi

• BindingList<T>
• Guide pratique pour implémenter l’interface ITypedList
• Liaison de données Windows Forms