IListSource Interfejs

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestawy:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Źródło:

IListSource.cs

Udostępnia funkcje obiektu w celu zwrócenia listy, którą można powiązać ze źródłem danych.

public interface class IListSource

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

[<System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type IListSource = interface

Public Interface IListSource

Pochodne

System.Data.DataSet

System.Data.DataTable

System.Data.Linq.EntitySet<TEntity>

System.Data.Linq.Table<TEntity>

System.Data.Objects.DataClasses.EntityCollection<TEntity>

System.Data.Objects.ObjectQuery

System.Data.Objects.ObjectQuery<T>

System.Data.Objects.ObjectResult

System.Web.UI.DataSourceControl

System.Web.UI.WebControls.SiteMapDataSource

System.Web.UI.WebControls.XmlDataSource

Atrybuty

TypeConverterAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak zaimplementować interfejs IListSource. Składnik o nazwie EmployeeListSource uwidacznia IList powiązanie danych przez zaimplementowanie GetList metody . Aby uzyskać pełną listę kodu, zobacz Instrukcje: implementowanie interfejsu IListSource.

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 => false;

    System.Collections.IList IListSource.GetList()
    {
        BindingList<Employee> ble = DesignMode
        ? []
        : [
            new("Aaberg, Jesper", 26000000),
            new ("Aaberg, Jesper", 26000000),
            new ("Cajhen, Janko", 19600000),
            new ("Furse, Kari", 19000000),
            new ("Langhorn, Carl", 16000000),
            new ("Todorov, Teodor", 15700000),
            new ("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

Uwagi

Zazwyczaj ten interfejs służy do zwracania listy, która może być powiązana ze źródłem danych, z obiektu, który nie implementuje IList się.

Powiązanie z danymi może wystąpić w czasie wykonywania lub w projektancie, ale istnieją reguły dla każdego. W czasie wykonywania można powiązać dane w dowolnym z następujących elementów:

• Array

• Implementator klasy IList, pod warunkiem, że implementator ma silnie typizowana Item[] właściwość (czyli jest to wszystko, Type ale Object). Można to zrobić, tworząc domyślną implementację Item[] prywatnego. Jeśli chcesz utworzyć obiekt IList , który jest zgodny z regułami silnie typizowanej kolekcji, należy pochodzić z klasy CollectionBase.

• Implementator obiektu ITypedList.

W projektancie można zainicjować powiązanie z Component obiektami, postępując zgodnie z tymi samymi regułami.

Note

Implementatory IListSource obiektu mogą zwracać obiekt IList , który zawiera kolekcję IList obiektów.

Właściwości

Nazwa	Opis
ContainsListCollection	Pobiera wartość wskazującą, czy kolekcja jest kolekcją IList obiektów.

Metody

Nazwa	Opis
GetList()	Zwraca obiekt IList , który może być powiązany ze źródłem danych z obiektu, który nie implementuje IList samego siebie.

Zobacz też

• IListSource
• ITypedList
• BindingList<T>
• IBindingList
• CollectionBase
• Powiązanie danych z formularzami systemu Windows