英語で読む

次の方法で共有


IListSource インターフェイス

定義

データ ソースに連結できるリストを返す機能をオブジェクトに提供します。

C#
public interface IListSource
C#
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public interface IListSource
C#
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public interface IListSource
派生
属性

IListSource インターフェイスの実装方法を示すコード例を次に示します。 GetList を実装することで、EmployeeListSource という名前のコンポーネントによってデータ バインディングの IList が公開されます。 完全なコード一覧については、「 方法: IListSource インターフェイスを実装する」を参照してください。

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

注釈

通常、このインターフェイスを使用して、データ ソースにバインドできるリストを、それ自体を実装 IList していないオブジェクトから返します。

データへのバインドは、実行時またはデザイナーで行うことができますが、それぞれにルールがあります。 実行時に、次のいずれかのデータにバインドできます。

  • Array

  • の実装者 IListが厳密に型指定された Item[] プロパティを持っている場合 (つまり、 Type は 以外 Objectです)。 これは、既定の実装 Item[] をプライベートにすることで実現できます。 厳密に型指定されたコレクションの規則に従う を IList 作成する場合は、 から CollectionBase派生する必要があります。

  • ITypedList実装者。

デザイナーでは、同じ規則に従ってオブジェクトへの Component バインドを初期化できます。

注意

IListSource実装者は、 オブジェクトのIListコレクションを含む を返IListすことができます。

プロパティ

ContainsListCollection

コレクションが IList オブジェクトのコレクションかどうかを示す値を取得します。

メソッド

GetList()

それ自体は IList を実装していないオブジェクトから、データ ソースに連結できる IList を返します。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

こちらもご覧ください