ExpandableCollectionConverter Class

public class ExpandableCollectionConverter : TypeConverter, ICollectionTypeConverter

public ExpandableCollectionConverter()

public ExpandableCollectionConverter(bool isCollectionReadOnly, bool areItemsReadOnly)

Parameter	Type	Description
isCollectionReadOnly	bool	Whether items can be added to or removed from the collection.
areItemsReadOnly	bool	Whether the values of the items in the collection are read-only and cannot be changed.

public bool AreItemsReadOnly { get; }

Property Value

bool:

true if the values of the items in the collection are read-only and cannot be changed; otherwise, false.

public bool IsCollectionReadOnly { get; }

Property Value

bool:

true if items can be added to or removed from the collection; otherwise, false.

public string MultipleItemsFormat { get; set; }

Property Value

string:

The format for text to return when there are multiple items. The default value is "{0} items".

public string NoItemsText { get; set; }

Property Value

string:

The text to return when there are no items. The default value is "No items".

public string OneItemText { get; set; }

Property Value

string:

The text to return when there is one item. The default value is "1 item".

public virtual bool AddItem(IPropertyModel propertyModel, object item)

Parameter	Type	Description
propertyModel	IPropertyModel	The IPropertyModel associated with the collection.
item	object	The item that should be added.

Returns

bool:

true if the item was added to the collection; otherwise, false.

public virtual bool CanAddItem(IPropertyModel propertyModel)

Parameter	Type	Description
propertyModel	IPropertyModel	The IPropertyModel associated with the collection.

Returns

bool:

true if a new item can be added to the collection; otherwise, false.

public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
destinationType	Type	A Type that represents the type you want to convert to.

Returns

bool:

true if this converter can perform the conversion; otherwise, false.

public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
culture	CultureInfo	A CultureInfo object. If null is passed, the current culture is assumed.
value	object	The Object to convert.
destinationType	Type	The Type to convert the value parameter to.

Returns

object:

An Object that represents the converted value.

protected virtual PropertyDescriptor CreateCollectionItemPropertyDescriptor(ITypeDescriptorContext context, Attribute[] attributes, ICollection collection, int index, object item, Type itemType)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
collection	ICollection	The collection that contains the item.
index	int	The index of the item in the collection.
item	object	The item in the collection.
itemType	Type	Type of the item.

Returns

PropertyDescriptor:

An instance of PropertyDescriptor for the collection item.

protected virtual PropertyDescriptor CreateDictionaryItemPropertyDescriptor(ITypeDescriptorContext context, Attribute[] attributes, IDictionary dictionary, object key, Type itemType)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
dictionary	IDictionary	The dictionary that contains the item.
key	object	The key of the item in the dictionary.
itemType	Type	Type of the item.

Returns

PropertyDescriptor:

An instance of PropertyDescriptor for the dictionary item.

public virtual object CreateItem(IPropertyModel propertyModel)

Parameter	Type	Description
propertyModel	IPropertyModel	The IPropertyModel associated with the collection.

Returns

object:

The item that was created.

protected virtual PropertyDescriptor CreateListItemPropertyDescriptor(ITypeDescriptorContext context, Attribute[] attributes, IList list, int index, Type itemType)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
list	IList	The list that contains the item.
index	int	The index of the item in the list.
itemType	Type	Type of the item.

Returns

PropertyDescriptor:

An instance of PropertyDescriptor for the list item.

protected virtual PropertyDescriptor[] GetCollectionProperties(ITypeDescriptorContext context, Attribute[] attributes, ICollection collection)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
collection	ICollection	The collection whose properties should be returned.

Returns

PropertyDescriptor[]:

A PropertyDescriptor array with the properties associated with the specified collection, or null if there are no properties.

protected virtual PropertyDescriptor[] GetDictionaryProperties(ITypeDescriptorContext context, Attribute[] attributes, IDictionary dictionary)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
dictionary	IDictionary	The dictionary whose properties should be returned.

Returns

PropertyDescriptor[]:

A PropertyDescriptor array with the properties associated with the specified dictionary, or null if there are no properties.

protected virtual PropertyDescriptor[] GetListProperties(ITypeDescriptorContext context, Attribute[] attributes, IList list)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.
list	IList	The list whose properties should be returned.

Returns

PropertyDescriptor[]:

A PropertyDescriptor array with the properties associated with the specified list, or null if there are no properties.

public override PropertyDescriptorCollection GetProperties(ITypeDescriptorContext context, object value, Attribute[] attributes)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.
value	object	An object that specifies the type to get the properties for.
attributes	Attribute[]	An array of type Attribute that will be used as a filter.

Returns

PropertyDescriptorCollection:

A PropertyDescriptorCollection with the properties that are exposed for this data type, or null if there are no properties.

public override bool GetPropertiesSupported(ITypeDescriptorContext context)

Parameter	Type	Description
context	ITypeDescriptorContext	An ITypeDescriptorContext that provides a format context.

Returns

bool:

true if properties are supported; otherwise, false.

Remarks

The default method implementation always returns true since child items should be accessible as nested properties.