ITypedList Schnittstelle

Definition

Stellt Funktionen bereit, mit denen das Schema für eine bindbare Liste ermittelt werden kann, in der für die Bindung verfügbare Eigenschaften von den öffentlichen Eigenschaften des Objekts, an das gebunden werden soll, unterschieden werden.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
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ITypedList -Schnittstelle implementiert wird.The following code example demonstrates how to implement the ITypedList interface. Ein generischer Typ SortableBindingList namens wird von BindingList<T> der-Klasse abgeleitet ITypedList und implementiert die-Schnittstelle.A generic type named SortableBindingList derives from the BindingList<T> class and implements the ITypedList interface. Eine vollständige Code Auflistung finden Sie unter Gewusst wie: Implementieren Sie die ITypedList-Schnittstelle.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

Hinweise

Verwenden Sie diese Schnittstelle, wenn Sie beispielsweise DataView ein-Objekt verwenden, das eine customer Tabelle darstellt, die Sie customer an die Eigenschaften des Objekts binden möchten, DataView das DataViewdas darstellt, und nicht die Eigenschaften des.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.

Diese Schnittstelle ist für die Entwurfszeit Unterstützung einer bindbaren Liste nicht erforderlich.This interface is not required for design-time support of a bindable list.

Die Bindung an Daten kann entweder zur Laufzeit oder in einem Designer erfolgen, es gibt jedoch Regeln für beide.Binding to data can occur either at run time or in a designer, but there are rules for both. Zur Laufzeit können Sie eine Bindung an Daten wie folgt herstellen:At run time, you can bind to data in any of the following:

  • Array

  • Implementierer IListvon, vorausgesetzt, der Implementierer Item[Int32] hat eine stark typisierte Eigenschaft Type (das heißt Object, das ist alles, aber).Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). Dies können Sie erreichen, indem Sie die Standard Implementierung Item[Int32] von "Privat" festlegen.You can accomplish this by making the default implementation of Item[Int32] private. Wenn Sie einen IList erstellen möchten, der den Regeln einer stark typisierten Auflistung folgt, sollten Sie von CollectionBaseableiten.If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • Implementierer ITypedListvon.Implementer of ITypedList.

In einem Designer können Sie die Bindung mit Component Objekten initialisieren, indem Sie die gleichen Regeln befolgen.In a designer, you can initialize binding to Component objects by following the same rules.

Weitere Informationen zum Binden an eine Datenquelle finden Sie unter der System.Windows.Forms.Binding -Klasse.For more information on binding to a data source, see the System.Windows.Forms.Binding class.

Methoden

GetItemProperties(PropertyDescriptor[])

Gibt die PropertyDescriptorCollection-Klasse zurück, die die Eigenschaften auf jedem Element darstellt, das zum Binden von Daten verwendet wird.Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.

GetListName(PropertyDescriptor[])

Gibt den Namen der Liste zurück.Returns the name of the list.

Gilt für:

Siehe auch