ITypedList Интерфейс

Определение

public interface class ITypedList

public interface ITypedList

type ITypedList = interface

Public Interface ITypedList

Производный

System.Data.DataView

System.Data.DataViewManager

System.Web.UI.WebControls.ListViewPagedDataSource

System.Web.UI.WebControls.PagedDataSource

System.Windows.Forms.BindingSource

Примеры

В следующем примере кода показано, как реализовать ITypedList интерфейс.The following code example demonstrates how to implement the ITypedList interface. Универсальный тип с именем SortableBindingList является производным от BindingList<T> класса и реализует ITypedList интерфейс.A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList 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

Комментарии

Используйте этот интерфейс, если, например, вы используете DataView объект, представляющий customer таблицу, которую нужно привязать к свойствам customer объекта, который DataView представляет, а не свойства 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.

Этот интерфейс не является обязательным для поддержки привязке списка во время разработки.This interface is not required for design-time support of a bindable list.

Привязка к данным может происходить либо во время выполнения, либо в конструкторе, но существуют правила для обоих типов.Binding to data can occur either at run time or in a designer, but there are rules for both. Во время выполнения можно выполнить привязку к данным в любом из следующих способов.At run time, you can bind to data in any of the following:

• Array

• Разработчик, при IList условии, что средство реализации имеет строго типизированное Item[] свойство (то есть Type все это, но Object ).Implementer of IList, provided the implementer has a strongly typed Item[] property (that is, the Type is anything but Object). Это можно сделать, сделав реализацию закрытой по умолчанию Item[] .You can accomplish this by making the default implementation of Item[] private. Если необходимо создать выражение IList , которое следует правилам строго типизированной коллекции, следует использовать класс, производный от CollectionBase .If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

• Разработчик класса ITypedList .Implementer of ITypedList.

В конструкторе можно инициализировать привязку к Component объектам, следуя тем же правилам.In a designer, you can initialize binding to Component objects by following the same rules.

Дополнительные сведения о привязке к источнику данных см. в разделе System.Windows.Forms.Binding класс.For more information on binding to a data source, see the System.Windows.Forms.Binding class.

Методы

Применяется к

См. также раздел

• BindingList<T>
• Практическое руководство. Реализация интерфейса ITypedListHow to: Implement the ITypedList Interface
• Привязка данных Windows FormsWindows Forms Data Binding