ITypedList ITypedList ITypedList ITypedList Interface

Définition

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.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
Dérivé

Exemples

L’exemple de code suivant montre comment implémenter la ITypedList interface.The following code example demonstrates how to implement the ITypedList interface. Un type générique nommé SortableBindingList dérive le BindingList<T> classe et implémente la ITypedList interface.A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList interface. Pour obtenir la liste complète de code, consultez Comment : Implémenter l’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
{
    [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

Utiliser cette interface si, par exemple, vous utilisez un DataView objet qui représente un customer table, que vous souhaitez lier aux propriétés le customer de l’objet qui le DataView représente, pas les propriétés de la DataView.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.

Cette interface n’est pas nécessaire pour la prise en charge au moment du design d’une liste pouvant être liée.This interface is not required for design-time support of a bindable list.

Liaison de données peut se produire au moment de l’exécution ou dans un concepteur, mais il existe des règles pour les deux.Binding to data can occur either at run time or in a designer, but there are rules for both. Au moment de l’exécution, vous pouvez lier aux données dans les cas suivants :At run time, you can bind to data in any of the following:

  • Array

  • Implémenteur de IList, à condition que l’implémenteur a fortement typé Item[Int32] propriété (autrement dit, le Type est tout sauf Object).Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). Vous pouvez y parvenir en rendant l’implémentation par défaut de Item[Int32] privé.You can accomplish this by making the default implementation of Item[Int32] 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.If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • Implémenteur de ITypedList.Implementer of ITypedList.

Dans un concepteur, vous pouvez initialiser la liaison aux Component objets en suivant les mêmes règles.In a designer, you can initialize binding to Component objects by following the same rules.

Pour plus d’informations sur la liaison à une source de données, consultez la System.Windows.Forms.Binding classe.For more information on binding to a data source, see the System.Windows.Forms.Binding class.

Méthodes

GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[])

Retourne l’objet PropertyDescriptorCollection qui représente les propriétés de chaque élément utilisé pour lier des données.Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.

GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[])

Retourne le nom de la liste.Returns the name of the list.

S’applique à

Voir aussi