This documentation is archived and is not being maintained.

ArrangedElementCollection Class

Represents a collection of objects.

Namespace:  System.Windows.Forms.Layout
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public class ArrangedElementCollection : IList, 
	ICollection, IEnumerable

The ArrangedElementCollection type exposes the following members.

Public propertyCountGets the number of elements in the collection.
Public propertyIsReadOnlyGets a value indicating whether the collection is read-only.

Public methodCopyToCopies the entire contents of this collection to a compatible one-dimensional Array, starting at the specified index of the target array.
Public methodEqualsDetermines whether two ArrangedElementCollection instances are equal. (Overrides Object.Equals(Object).)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetEnumeratorReturns an enumerator for the entire collection.
Public methodGetHashCodeReturns the hash code for this instance. (Overrides Object.GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

Public Extension MethodAsParallelEnables parallelization of a query. (Defined by ParallelEnumerable.)
Public Extension MethodAsQueryableConverts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension MethodCast<TResult>Converts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension MethodOfType<TResult>Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)

Explicit interface implemetationPrivate propertyICollection.IsSynchronizedFor a description of this member, see the ICollection.IsSynchronized property.
Explicit interface implemetationPrivate propertyICollection.SyncRootFor a description of this member, see the ICollection.SyncRoot property.
Explicit interface implemetationPrivate methodIList.AddFor a description of this member, see the IList.Add method.
Explicit interface implemetationPrivate methodIList.ClearFor a description of this member, see the IList.Clear method.
Explicit interface implemetationPrivate methodIList.ContainsFor a description of this member, see the IList.Contains method.
Explicit interface implemetationPrivate methodIList.IndexOfFor a description of this member, see the IList.IndexOf method.
Explicit interface implemetationPrivate methodIList.InsertFor a description of this member, see the IList.Insert method.
Explicit interface implemetationPrivate propertyIList.IsFixedSizeFor a description of this member, see the IList.IsFixedSize property.
Explicit interface implemetationPrivate propertyIList.ItemFor a description of this member, see the IList.Item property.
Explicit interface implemetationPrivate methodIList.RemoveFor a description of this member, see the IList.Remove method.
Explicit interface implemetationPrivate methodIList.RemoveAtFor a description of this member, see the IList.RemoveAt method.

The ArrangedElementCollection class represents a collection of objects arranged on a design surface or inside a parent System.Windows.Forms.ContainerControl.

There are no publicly defined constructors in ArrangedElementCollection because it is designed to be used only internally within the .NET Framework. However, classes derived from ArrangedElementCollection, such as System.Windows.Forms.Control.ControlCollection, are available to the developer.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Public static (Shared in Visual Basic) members of this type are thread safe. Instance members are not guaranteed to be thread safe.

An ArrangedElementCollection can support multiple readers concurrently, as long as the collection is not modified. The GetEnumerator method returns an IEnumerator that can be used to access elements.

Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads could still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.