ITypedList Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona funcionalidad para detectar el esquema de una lista enlazable, donde las propiedades disponibles para el enlace se diferencian de las propiedades públicas del objeto al que se va a enlazar.
public interface class ITypedList
public interface ITypedList
type ITypedList = interface
Public Interface ITypedList
- Derivado
Ejemplos
En el siguiente ejemplo de código se muestra cómo implementar la interfaz ITypedList. Un tipo genérico denominado SortableBindingList
deriva de la clase BindingList<T> e implementa la interfaz ITypedList. Para obtener una lista de código completa, vea Cómo: Implementar la interfaz ITypedList.
using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.Windows.Forms;
using System.Collections;
using System.Reflection;
namespace ITypedListCS
{
[Serializable()]
public class SortableBindingList<T> : BindingList<T>, ITypedList
{
[NonSerialized()]
private PropertyDescriptorCollection properties;
public SortableBindingList() : base()
{
// Get the 'shape' of the list.
// Only get the public properties marked with Browsable = true.
PropertyDescriptorCollection pdc = TypeDescriptor.GetProperties(
typeof(T),
new Attribute[] { new BrowsableAttribute(true) });
// Sort the properties.
properties = pdc.Sort();
}
#region ITypedList Implementation
public PropertyDescriptorCollection GetItemProperties(PropertyDescriptor[] listAccessors)
{
PropertyDescriptorCollection pdc;
if (listAccessors!=null && listAccessors.Length>0)
{
// Return child list shape.
pdc = ListBindingHelper.GetListItemProperties(listAccessors[0].PropertyType);
}
else
{
// Return properties in sort order.
pdc = properties;
}
return pdc;
}
// This method is only used in the design-time framework
// and by the obsolete DataGrid control.
public string GetListName(PropertyDescriptor[] listAccessors)
{
return typeof(T).Name;
}
#endregion
}
}
Imports System.ComponentModel
Imports System.Collections.Generic
Imports System.Windows.Forms
<Serializable()> _
Public Class SortableBindingList(Of Tkey)
Inherits BindingList(Of Tkey)
Implements ITypedList
<NonSerialized()> _
Private properties As PropertyDescriptorCollection
Public Sub New()
MyBase.New()
' Get the 'shape' of the list.
' Only get the public properties marked with Browsable = true.
Dim pdc As PropertyDescriptorCollection = TypeDescriptor.GetProperties(GetType(Tkey), New Attribute() {New BrowsableAttribute(True)})
' Sort the properties.
properties = pdc.Sort()
End Sub
#Region "ITypedList Implementation"
Public Function GetItemProperties(ByVal listAccessors() As System.ComponentModel.PropertyDescriptor) As System.ComponentModel.PropertyDescriptorCollection Implements System.ComponentModel.ITypedList.GetItemProperties
Dim pdc As PropertyDescriptorCollection
If (Not (listAccessors Is Nothing)) And (listAccessors.Length > 0) Then
' Return child list shape
pdc = ListBindingHelper.GetListItemProperties(listAccessors(0).PropertyType)
Else
' Return properties in sort order
pdc = properties
End If
Return pdc
End Function
' This method is only used in the design-time framework
' and by the obsolete DataGrid control.
Public Function GetListName( _
ByVal listAccessors() As PropertyDescriptor) As String _
Implements System.ComponentModel.ITypedList.GetListName
Return GetType(Tkey).Name
End Function
#End Region
End Class
Comentarios
Use esta interfaz si, por ejemplo, está usando un objeto que representa una DataViewcustomer
tabla, quiere enlazar a las propiedades del customer
objeto que DataView representa, no a las propiedades de DataView.
Esta interfaz no es necesaria para la compatibilidad en tiempo de diseño de una lista enlazable.
El enlace a los datos puede producirse en tiempo de ejecución o en un diseñador, pero hay reglas para ambos. En tiempo de ejecución, puede enlazar a datos en cualquiera de los siguientes elementos:
Implementador de IList, siempre que el implementador tenga una propiedad fuertemente tipada Item[] (es decir, el Type es cualquier cosa pero Object). Para ello, puede realizar la implementación predeterminada de Item[] private. Si desea crear un IList objeto que siga las reglas de una colección fuertemente tipada, debe derivar de CollectionBase.
Implementador de ITypedList.
En un diseñador, puede inicializar el enlace a Component objetos siguiendo las mismas reglas.
Para obtener más información sobre el enlace a un origen de datos, consulte la System.Windows.Forms.Binding clase .
Métodos
GetItemProperties(PropertyDescriptor[]) |
Devuelve el PropertyDescriptorCollection que representa las propiedades de cada elemento utilizado para enlazar datos. |
GetListName(PropertyDescriptor[]) |
Devuelve el nombre de la lista. |