ITypedList Interfaccia

Definizione

Fornisce le funzionalità per scoprire lo schema di un elenco associabile, in cui le proprietà disponibili per l'associazione differiscono dalle proprietà pubbliche dell'oggetto verso cui effettuare l'associazione.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
Derivato

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come implementare l'interfaccia ITypedList.The following code example demonstrates how to implement the ITypedList interface. Un tipo generico denominato SortableBindingList deriva dalla classe BindingList<T> e implementa l'interfaccia ITypedList.A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList interface. Per un listato di codice completo, vedere procedura: implementare l'interfaccia 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

Commenti

Utilizzare questa interfaccia se, ad esempio, si utilizza un oggetto DataView che rappresenta una tabella di customer, si desidera eseguire l'associazione alle proprietà nell'oggetto customer rappresentato dall'DataView, non le proprietà del 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.

Questa interfaccia non è necessaria per il supporto in fase di progettazione di un elenco associabile.This interface is not required for design-time support of a bindable list.

Il binding ai dati può verificarsi in fase di esecuzione o in una finestra di progettazione, ma sono presenti regole per entrambe.Binding to data can occur either at run time or in a designer, but there are rules for both. In fase di esecuzione è possibile associare i dati in uno dei seguenti elementi:At run time, you can bind to data in any of the following:

  • Array

  • Responsabile dell'implementazione di IList, a condizione che l'implementatore disponga di una proprietà Item[Int32] fortemente tipizzata, ovvero che il Type sia tutt'altro che Object.Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). È possibile eseguire questa operazione rendendo l'implementazione predefinita di Item[Int32] privato.You can accomplish this by making the default implementation of Item[Int32] private. Se si desidera creare un IList che segue le regole di una raccolta fortemente tipizzata, è necessario derivare da CollectionBase.If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • Responsabile dell'implementazione di ITypedList.Implementer of ITypedList.

In una finestra di progettazione, è possibile inizializzare l'associazione a oggetti Component seguendo le stesse regole.In a designer, you can initialize binding to Component objects by following the same rules.

Per ulteriori informazioni sull'associazione a un'origine dati, vedere la classe System.Windows.Forms.Binding.For more information on binding to a data source, see the System.Windows.Forms.Binding class.

Metodi

GetItemProperties(PropertyDescriptor[])

Restituisce l'oggetto PropertyDescriptorCollection che rappresenta le proprietà di ogni elemento usato per associare i dati.Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.

GetListName(PropertyDescriptor[])

Restituisce il nome dell'elenco.Returns the name of the list.

Si applica a

Vedi anche