IListSource IListSource IListSource IListSource Interface

定義

提供功能,使物件傳回可繫結至資料來源的清單。Provides functionality to an object to return a list that can be bound to a data source.

public interface class IListSource
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=2.0.5.0, 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的元件會IList藉由執行GetList方法, 來公開資料系結的。A 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)
        {
            container.Add(this);
        }

        #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;
        }

        #endregion
    }
}
Imports System.ComponentModel

Public Class EmployeeListSource
    Inherits Component
    Implements IListSource

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

        'Required for Windows.Forms Class Composition Designer support
        Container.Add(Me)

    End Sub

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

        'This call is required by the Component Designer.
        InitializeComponent()

    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
            components.Dispose()
        End If
        MyBase.Dispose(disposing)
    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
        Get
            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[Int32]強型別屬性Type (亦即, 是任何Object專案, 但不包括)。Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). 您可以藉由進行私用的預設實Item[Int32]值來完成這項工作。You can accomplish this by making the default implementation of Item[Int32] private. 如果您想要建立IList遵循強型別集合規則的, 您應該衍生自。 CollectionBaseIf 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.

屬性

ContainsListCollection ContainsListCollection ContainsListCollection ContainsListCollection

取得值,表示集合是否為 IList 物件的集合。Gets a value indicating whether the collection is a collection of IList objects.

方法

GetList() GetList() GetList() GetList()

從本身沒有實作 IList 的物件傳回可以繫結至資料來源的 IListReturns an IList that can be bound to a data source from an object that does not implement an IList itself.

適用於

另請參閱