IListSource Interface


向对象提供返回可以绑定到数据源列表的功能。Provides functionality to an object to return a list that can be bound to a data source.

public interface class IListSource
public interface IListSource
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public interface IListSource
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public interface IListSource
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public interface IListSource
type IListSource = interface
Public Interface IListSource


下面的代码示例演示如何实现 IListSource 接口。The following code example demonstrates how to implement the IListSource interface. 名为 EmployeeListSource 的组件通过实现 GetList 方法公开了数据绑定的 IListA component named EmployeeListSource exposes an IList for data binding by implementing the GetList method. 有关完整的代码清单,请参阅如何:实现 IListSource 接口For a full code listing, see How to: Implement the IListSource Interface.

using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;

namespace IListSourceCS
    public class EmployeeListSource : Component, IListSource
        public EmployeeListSource() {}

        public EmployeeListSource(IContainer container)

        #region IListSource Members

        bool IListSource.ContainsListCollection
            get { return false; }

        System.Collections.IList IListSource.GetList()
            BindingList<Employee>   ble = new BindingList<Employee>();

            if (!this.DesignMode)
                ble.Add(new Employee("Aaberg, Jesper", 26000000));
                ble.Add(new Employee("Cajhen, Janko", 19600000));
                ble.Add(new Employee("Furse, Kari", 19000000));
                ble.Add(new Employee("Langhorn, Carl", 16000000));
                ble.Add(new Employee("Todorov, Teodor", 15700000));
                ble.Add(new Employee("Verebélyi, Ágnes", 15700000));

            return ble;

Imports System.ComponentModel

Public Class EmployeeListSource
    Inherits Component
    Implements IListSource

    <System.Diagnostics.DebuggerNonUserCode()> _
Public Sub New(ByVal Container As System.ComponentModel.IContainer)

        'Required for Windows.Forms Class Composition Designer support

    End Sub

    <System.Diagnostics.DebuggerNonUserCode()> _
    Public Sub New()

        'This call is required by the Component Designer.

    End Sub

    'Component overrides dispose to clean up the component list.
    <System.Diagnostics.DebuggerNonUserCode()> _
    Protected Overrides Sub Dispose(ByVal disposing As Boolean)
        If disposing AndAlso components IsNot Nothing Then
        End If
    End Sub

    'Required by the Component Designer
    Private components As System.ComponentModel.IContainer

    'NOTE: The following procedure is required by the Component Designer
    'It can be modified using the Component Designer.
    'Do not modify it using the code editor.
    <System.Diagnostics.DebuggerStepThrough()> _
    Private Sub InitializeComponent()
        components = New System.ComponentModel.Container()
    End Sub

#Region "IListSource Members"

    Public ReadOnly Property ContainsListCollection() As Boolean Implements System.ComponentModel.IListSource.ContainsListCollection
            Return False
        End Get
    End Property

    Public Function GetList() As System.Collections.IList Implements System.ComponentModel.IListSource.GetList

        Dim ble As New BindingList(Of Employee)

        If Not Me.DesignMode Then
            ble.Add(New Employee("Aaberg, Jesper", 26000000))
            ble.Add(New Employee("Cajhen, Janko", 19600000))
            ble.Add(New Employee("Furse, Kari", 19000000))
            ble.Add(New Employee("Langhorn, Carl", 16000000))
            ble.Add(New Employee("Todorov, Teodor", 15700000))
            ble.Add(New Employee("Verebélyi, Ágnes", 15700000))
        End If

        Return ble

    End Function

#End Region

End Class


通常,使用此接口可以从未实现 IList 本身的对象返回一个可绑定到数据源的列表。You typically use this interface to return a list that can be bound to a data source, from an object that does not implement IList itself.

绑定到数据时,可以在运行时或设计器中进行,但每个都有规则。Binding to data can occur at either run time or in a designer, but there are rules for each. 在运行时,可以通过以下任一操作绑定到数据: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.


IListSource 的实施者可以返回一个 IList,其中包含一个 IList 对象的集合。Implementers of IListSource can return an IList that contains a collection of IList objects.



获取一个值,该值指示集合是否是 IList 对象的集合。Gets a value indicating whether the collection is a collection of IList objects.



从不实现 IList 本身的对象返回可以绑定到数据源的 IListReturns an IList that can be bound to a data source from an object that does not implement an IList itself.

Applies to

See also