IListSource IListSource IListSource IListSource Interface

Definition

Stellt Funktionen für ein Objekt bereit, mit denen dieses eine Liste zurückgeben kann, die an eine Datenquelle gebunden werden kann.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
Abgeleitet
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie zum Implementieren der IListSource Schnittstelle.The following code example demonstrates how to implement the IListSource interface. Eine Komponente namens EmployeeListSource macht eine IList für die Datenbindung, durch die Implementierung der GetList Methode.A component named EmployeeListSource exposes an IList for data binding by implementing the GetList method. Eine vollständige codeauflistung finden Sie unter Vorgehensweise: Implementieren der IListSource-Schnittstelle.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

Hinweise

Diese Schnittstelle in der Regel verwenden, um eine Liste zurückzugeben, die an eine Datenquelle aus einem Objekt gebunden werden kann, die nicht implementiert IList selbst.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.

Eine Bindung an Daten kann auftreten, zur Laufzeit oder in einem Designer, aber die Regeln für die einzelnen vorhanden sind.Binding to data can occur at either run time or in a designer, but there are rules for each. Zur Laufzeit können Sie Daten in eine der folgenden binden:At run time, you can bind to data in any of the following:

  • Array

  • Implementierer von IList, sofern es sich bei die Implementierung eines stark typisierten hat Item[Int32] Eigenschaft (d. h. der Type ist beliebig, aber Object).Implementer of IList, provided the implementer has a strongly typed Item[Int32] property (that is, the Type is anything but Object). Sie erreichen dies, indem Sie die standardmäßige Implementierung des machen Item[Int32] private.You can accomplish this by making the default implementation of Item[Int32] private. Wenn Sie erstellen möchten eine IList , der die Regeln für eine stark typisierte Auflistung folgt, sollten Sie die Ableitung von CollectionBase.If you want to create an IList that follows the rules of a strongly typed collection, you should derive from CollectionBase.

  • Implementierung von ITypedList.Implementer of ITypedList.

Sie können in einem Designer Bindung zu initialisieren Component Objekte, indem Sie nach den gleichen Regeln.In a designer, you can initialize binding to Component objects by following the same rules.

Hinweis

Implementierungen von IListSource können Zurückgeben einer IList , enthält eine Auflistung von IList Objekte.Implementers of IListSource can return an IList that contains a collection of IList objects.

Eigenschaften

ContainsListCollection ContainsListCollection ContainsListCollection ContainsListCollection

Ruft einen Wert ab, der angibt, ob die Auflistung eine Auflistung von IList-Objekten ist.Gets a value indicating whether the collection is a collection of IList objects.

Methoden

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

Gibt eine IList zurück, die an eine Datenquelle eines Objekts gebunden werden kann, das selbst keine IList implementiert.Returns an IList that can be bound to a data source from an object that does not implement an IList itself.

Gilt für:

Siehe auch