Control.ControlCollection

Wisej.Web.Control ControlCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.5.0.0)

Represents a collection of Control objects.

C#

public class ControlCollection : ControlCollection, IList<Control>, ICollection<Control>, IEnumerable<Control>, IWisejSynchronized

VB.NET

Public Class ControlCollection
    Inherits ControlCollection
    Implements IList(Of Control), ICollection(Of Control), IEnumerable(Of Control), IWisejSynchronized

Constructors

ControlCollection(owner)

Initializes a new instance of the ControlCollection class.

Name	Type	Description
owner	Control	The Control that owns this collection.

Properties

IsDisposed

Boolean: Returns whether the owner control has already been disposed.

Item(index)

Control: Returns the Control at the specified indexed location.

Item(key)

Control: Returns the Control with the specified key in the collection.

Owner

Control: Returns the control that owns this ControlCollection.

Methods

Add(child)

Adds the specified control to the control collection.

Parameter	Type	Description
child	Control	The Control to add.

AddRange(controls)

Adds an array of control objects to the collection.

Parameter	Type	Description
controls	Control[]	An array of Control objects to add to the collection.

Clear()

Removes all controls from the collection.

Clear(dispose)

Removes and disposes all controls from the collection.

Parameter	Type	Description
dispose	Boolean	Indicates whether the controls removed from the collection should be disposed.

Contains(control)

Determines whether the specified control is a member of the collection.

Parameter	Type	Description
control	Control	The Control to locate in the collection.

Returns: Boolean. true if the Control is a member of the collection; otherwise, false.

ContainsKey(key)

Determines whether the ControlCollection contains an item with the specified key.

Parameter	Type	Description
key	String	The key to locate in the ControlCollection.

Returns: Boolean. true if the ControlCollection contains an item with the specified key; otherwise, false.

Find(type, searchAllChildren)

Searches for controls by their type and builds an array of all the controls that match.

Parameter	Type	Description
type	Type	The type of the controls to locate in the ControlCollection.
searchAllChildren	Boolean	true to search all child controls; otherwise, false.

Returns: Control[]. Array of controls that are derived from the specified type .

Throws:

• ArgumentNullException type is null.

Find(key, searchAllChildren)

Searches for controls by their name and builds an array of all the controls that match.

Parameter	Type	Description
key	String	The key to located in the ControlCollection.
searchAllChildren	Boolean	true to search all child controls; otherwise, false.

Returns: Control[]. Array of controls with the specified name.

Throws:

• ArgumentNullException The key parameter is null or an empty string ("").

GetChildIndex(child, throwException)

Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

Parameter	Type	Description
child	Control	The Control to search for in the control collection.
throwException	Boolean	true to throw an exception if the Control specified in the child parameter is not a control in the ControlCollection; otherwise, false.

Returns: Int32. A zero-based index value that represents the location of the specified child control within the control collection; otherwise -1 if the specified Control is not found in the ControlCollection.

Throws:

• ArgumentException The child Control is not in the ControlCollection, and the throwException parameter value is true.

GetEnumerator()

Retrieves a reference to an enumerator object that is used to iterate over a ControlCollection.

Returns: IEnumerator. An IEnumerator.

IndexOf(control)

Retrieves the index of the specified control in the control collection.

Parameter	Type	Description
control	Control	The Control to locate in the collection.

Returns: Int32. A zero-based index value that represents the position of the specified Control in the ControlCollection.

IndexOfKey(key)

Retrieves the index of the first occurrence of the specified item within the collection.

Parameter	Type	Description
key	String	The name of the control to search for.

Returns: Int32. The zero-based index of the first occurrence of the control with the specified name in the collection.

Remove(child)

Removes the specified control from the control collection.

Parameter	Type	Description
child	Control	The Control to remove.

RemoveByKey(key)

Removes the child control with the specified key.

Parameter	Type	Description
key	String	The name of the child control to remove.

SetChildIndex(child, newIndex)

Sets the index of the specified child control in the collection.

Parameter	Type	Description
child	Control	The child control to search for.
newIndex	Int32	The new index value of the control.