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 default value is "{0} items".

public string NoItemsText { get; set; }

Property Value

string:

The default value is "No items".

public string OneItemText { get; set; }

Property Value

string:

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. 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.

Exceptions

Type	Condition
ArgumentNullException	The destinationType parameter is null.
NotSupportedException	The conversion cannot be performed.

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 of array for which to get properties.
attributes	Attribute[]	An array of type Attribute that is 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 GetProperties(object) should be called to find the properties of this object; otherwise, false.

Remarks

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