ITypedList Interface

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Fournit des fonctionnalités permettant de découvrir le schéma d'une liste pouvant être liée, dans laquelle les propriétés disponibles pour la liaison diffèrent des propriétés publiques de l'objet vers lequel établir la liaison.

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 la liste complète du code, consultez Guide pratique pour implémenter l’interface ITypedList.

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

namespace ITypedListCS
{
    [Serializable()]
    public class SortableBindingList<T> : BindingList<T>, ITypedList
    {
        [NonSerialized()]
        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(
                typeof(T), 
                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);
            }
            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)
        {   
            return 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 instance, vous utilisez un DataView objet qui représente une customer table, que vous souhaitez lier aux propriétés de l’objet customer que représente le DataView , et non aux propriétés de .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 à des 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’un des éléments suivants :

• Array

• Implémenteur de IList, à condition que l’implémenteur ait une propriété fortement typée Item[] (autrement dit, est Type tout sauf Object). Pour ce faire, vous pouvez rendre l’implémentation par défaut privée Item[] . 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 objets en Component 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 .

Méthodes

GetItemProperties(PropertyDescriptor[])	Retourne l’objet PropertyDescriptorCollection qui représente les propriétés de chaque élément utilisé pour lier des données.
GetListName(PropertyDescriptor[])	Retourne le nom de la liste.

Voir aussi

• BindingList<T>
• Procédure : implémenter l’interface ITypedList
• liaison de données Windows Forms