IListSource Gränssnitt

Definition

Namnområde:
System.ComponentModel
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Tillhandahåller funktioner för ett objekt för att returnera en lista som kan bindas till en datakälla.

public interface class IListSource
public interface IListSource
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=2.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")]
public interface IListSource
type IListSource = interface
[<System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataSourceConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type IListSource = interface
[<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
Härledda
Attribut
TypeConverterAttribute

Exempel

Följande kodexempel visar hur du implementerar IListSource-gränssnittet. En komponent med namnet EmployeeListSource exponerar en IList för databindning genom att implementera GetList metoden. En fullständig kodlista finns i Så här implementerar du IListSource-gränssnittet.

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

Kommentarer

Du använder vanligtvis det här gränssnittet för att returnera en lista som kan bindas till en datakälla, från ett objekt som inte implementerar IList sig självt.

Bindning till data kan ske antingen vid körning eller i en designer, men det finns regler för var och en. Vid körning kan du binda till data i något av följande:

  • Array

  • Implementer för IList, förutsatt att implementeraren har en starkt typad Item[] egenskap (det vill: Type är allt annat än Object). Du kan göra detta genom att göra standardimplementeringen av Item[] privat. Om du vill skapa en IList som följer reglerna för en starkt typad samling bör du härleda från CollectionBase.

  • Implementerare för ITypedList.

I en designer kan du initiera bindning till objekt genom att Component följa samma regler.

Note

Implementerare av IListSource kan returnera en IList som innehåller en samling IList objekt.

Egenskaper

Name Description
ContainsListCollection

Hämtar ett värde som anger om samlingen är en samling IList objekt.

Metoder

Name Description
GetList()

Returnerar en IList som kan bindas till en datakälla från ett objekt som inte implementerar en IList själv.

Gäller för

Se även