IListSource Schnittstelle

Definition

Namespace:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Quelle:

IListSource.cs

Stellt Funktionen für ein Objekt bereit, um eine Liste zurückzugeben, die an eine Datenquelle gebunden werden kann.

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

Abgeleitet

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

Attribute

TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IListSource-Schnittstelle implementiert wird. Eine benannte EmployeeListSource Komponente macht eine IList Datenbindung durch Implementieren der GetList Methode verfügbar. Eine vollständige Codeauflistung finden Sie unter How to: Implement the IListSource Interface.

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

Hinweise

In der Regel verwenden Sie diese Schnittstelle, um eine Liste zurückzugeben, die an eine Datenquelle gebunden werden kann, aus einem Objekt, das sich nicht selbst implementiert IList .

Die Bindung an Daten kann entweder zur Laufzeit oder in einem Designer erfolgen, es gibt jedoch Regeln für jeden. Zur Laufzeit können Sie eine Bindung an Daten in einer der folgenden Aktionen vornehmen:

• Array

• Implementierer von IList, vorausgesetzt, der Implementierer verfügt über eine stark typierte Item[] Eigenschaft (d. s. dies Type ist alles andere Object). Sie können dies erreichen, indem Sie die Standardimplementierung von Item[] "privat" vornehmen. Wenn Sie ein Objekt IList erstellen möchten, das den Regeln einer stark typierten Auflistung folgt, sollten Sie von CollectionBase.

• Implementierer von ITypedList.

In einem Designer können Sie die Bindung an Component Objekte initialisieren, indem Sie die gleichen Regeln verwenden.

Note

Implementierer von IListSource can return an IList that contains a collection of IList objects.

Eigenschaften

Name	Beschreibung
ContainsListCollection	Ruft einen Wert ab, der angibt, ob es sich bei der Auflistung um eine Auflistung von IList Objekten handelt.

Methoden

Name	Beschreibung
GetList()	Gibt einen IList Wert zurück, der von einem Objekt aus an eine Datenquelle gebunden werden kann, das keine selbst implementiert IList .

Weitere Informationen

• IListSource
• ITypedList
• BindingList<T>
• IBindingList
• CollectionBase
• Datenbindung und Windows Forms