ITypedList ITypedList ITypedList ITypedList Interface

Definition

Proporciona funcionalidad para detectar el esquema de una lista enlazable, donde las propiedades disponibles para el enlace se diferencian de las propiedades públicas del objeto al que se va a enlazar. 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
Derived

Examples

En el ejemplo de código siguiente se muestra cómo implementar el ITypedList interfaz.The following code example demonstrates how to implement the ITypedList interface. Un tipo genérico denominado SortableBindingList deriva el BindingList<T> clase e implementa el ITypedList interfaz.A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList interface. Para obtener una lista de código completo, vea Cómo: implementar la interfaz 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

Remarks

Usar esta interfaz si, por ejemplo, usa un DataView objeto que representa un customer tabla, que desea enlazar a las propiedades el customer objeto al que el DataView representa, no las propiedades 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.

Esta interfaz no es necesaria para la compatibilidad en tiempo de diseño de una lista enlazable.This interface is not required for design-time support of a bindable list.

Puede producir el enlace a datos en tiempo de ejecución o en un diseñador, pero existen reglas para ambos.Binding to data can occur either at run time or in a designer, but there are rules for both. En tiempo de ejecución, puede enlazar a datos en cualquiera de las siguientes acciones:At run time, you can bind to data in any of the following:

  • Array

  • Implementador de IList, siempre y cuando tenga un fuertemente tipado Item[Int32] propiedad (es decir, el Type es cualquier cosa menos Object).Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). Puede hacerlo mediante la realización de la implementación predeterminada de Item[Int32] privada.You can accomplish this by making the default implementation of Item[Int32] private. Si desea crear un IList que sigue las reglas de una colección fuertemente tipada, debe derivar de CollectionBase.If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • Implementador de ITypedList.Implementer of ITypedList.

En un diseñador, se puede inicializar el enlace a Component objetos siguiendo las mismas reglas.In a designer, you can initialize binding to Component objects by following the same rules.

Para obtener más información sobre cómo enlazar a un origen de datos, vea el System.Windows.Forms.Binding clase.For more information on binding to a data source, see the System.Windows.Forms.Binding class.

Methods

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

Devuelve el PropertyDescriptorCollection que representa las propiedades de cada elemento utilizado para enlazar datos. Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.

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

Devuelve el nombre de la lista. Returns the name of the list.

Applies to

See Also