CollectionEditor Class

Provides a user interface that can edit most types of collections at design time.

Namespace:   System.ComponentModel.Design
Assembly:  System.Design (in System.Design.dll)

public class CollectionEditor : UITypeEditor
public ref class CollectionEditor : UITypeEditor
type CollectionEditor = 
        inherit UITypeEditor
Public Class CollectionEditor
	Inherits UITypeEditor
System_CAPS_pubmethod CollectionEditor

Initializes a new instance of the CollectionEditor class using the specified collection type.


Gets the data type of each item in the collection.


Gets the data type of the collection object.


Gets a type descriptor that indicates the current context.


Gets the Help keyword to display the Help topic or topic list for when the editor's dialog box Help button or the F1 key is pressed.


Gets a value indicating whether drop-down editors should be resizable by the user.(Inherited from UITypeEditor.)


Gets the available types of items that can be created for this collection.

System_CAPS_protmethod CancelChanges

Cancels changes to the collection.

System_CAPS_protmethod CanRemoveInstance

Indicates whether original members of the collection can be removed.

System_CAPS_protmethod CanSelectMultipleInstances

Indicates whether multiple collection items can be selected at once.

System_CAPS_protmethod CreateCollectionForm

Creates a new form to display and edit the current collection.

System_CAPS_protmethod CreateCollectionItemType

Gets the data type that this collection contains.

System_CAPS_protmethod CreateInstance

Creates a new instance of the specified collection item type.

System_CAPS_protmethod CreateNewItemTypes

Gets the data types that this collection editor can contain.

System_CAPS_protmethod DestroyInstance

Destroys the specified instance of the object.

System_CAPS_pubmethod EditValue

Edits the value of the specified object using the editor style indicated by the GetEditStyle method.(Inherited from UITypeEditor.)

System_CAPS_pubmethod EditValue

Edits the value of the specified object using the specified service provider and context.(Overrides UITypeEditorEditValue.)

System_CAPS_pubmethod Equals

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethod Finalize

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_protmethod GetDisplayText

Retrieves the display text for the given list item.

System_CAPS_pubmethod GetEditStyle

Gets the editor style used by the EditValue method.(Inherited from UITypeEditor.)

System_CAPS_pubmethod GetEditStyle

Gets the edit style used by the EditValue method.(Overrides UITypeEditorGetEditStyle.)

System_CAPS_pubmethod GetHashCode

Serves as the default hash function. (Inherited from Object.)

System_CAPS_protmethod GetItems

Gets an array of objects containing the specified collection.

System_CAPS_protmethod GetObjectsFromInstance

Returns a list containing the given object

System_CAPS_pubmethod GetPaintValueSupported

Indicates whether this editor supports painting a representation of an object's value.(Inherited from UITypeEditor.)

System_CAPS_pubmethod GetPaintValueSupported

Indicates whether the specified context supports painting a representation of an object's value within the specified context.(Inherited from UITypeEditor.)

System_CAPS_protmethod GetService

Gets the requested service, if it is available.

System_CAPS_pubmethod GetType

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethod MemberwiseClone

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethod PaintValue

Paints a representation of the value of the specified object to the specified canvas.(Inherited from UITypeEditor.)

System_CAPS_pubmethod PaintValue

Paints a representation of the value of an object using the specified PaintValueEventArgs.(Inherited from UITypeEditor.)

System_CAPS_protmethod SetItems

Sets the specified array as the items of the collection.

System_CAPS_protmethod ShowHelp

Displays the default Help topic for the collection editor.

System_CAPS_pubmethod ToString

Returns a string that represents the current object.(Inherited from Object.)

Notes to Inheritors:

This editor can edit collections that have an Item property. The editor can determine the type of the collection from the Item property, if it exists. If the collection does not have this property, or if you want to provide collections of more than one type, you can override certain protected members of this class to customize the editor to support other types of collections.


The following code example uses an EditorAttribute to associate the CollectionEditor with a property.

[EditorAttribute(typeof(System.ComponentModel.Design.CollectionEditor), typeof(System.Drawing.Design.UITypeEditor))]
public ICollection testCollection
        return Icollection;
        Icollection = value;
private ICollection Icollection;
<EditorAttribute(GetType(System.ComponentModel.Design.CollectionEditor), GetType(System.Drawing.Design.UITypeEditor))>  _
Public Property testCollection() As ICollection
      Return Icollection
   End Get
      Icollection = value
   End Set
End Property
Private Icollection As ICollection
   property ICollection^ testCollection 
      ICollection^ get()
         return Icollection;
      void set( ICollection^ value )
         Icollection = value;
   ICollection^ Icollection;
Version Information
.NET Framework
Available since 1.1
Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top