public abstract class CollectionEx : Object, IList, ICollection, IEnumerable, ICloneable, ISerializable, IServiceReferenceHolder, IServiceReferenceProvider

Remarks

This class provides a base implementation of the IList and IEnumerable interfaces. The internal implementation of the collection is an ArrayList.

Constructors

CollectionEx()

Initializes a new instance of the CollectionEx class.

Declaration

public CollectionEx()

CollectionEx(CollectionEx)

Initializes a new instance of the CollectionEx class.

Declaration

public CollectionEx(CollectionEx src)

Parameters

Type	Name	Description
CollectionEx	src	The collection.

CollectionEx(Object)

Initializes a new instance of the CollectionEx class.

Declaration

public CollectionEx(object owner)

Parameters

Type	Name	Description
System.Object	owner	The collection owner

CollectionEx(SerializationInfo, StreamingContext)

Initializes a new instance of the CollectionEx class.

Declaration

public CollectionEx(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	The serialization info.
System.Runtime.Serialization.StreamingContext	context	The serialization context.

Properties

Count

Gets the number of elements contained in the System.Collections.ICollection.

Declaration

public int Count { get; }

Property Value

Type
System.Int32

EventSink

Gets the reference event sink.

Declaration

protected EventSink EventSink { get; }

Property Value

Type	Description
EventSink	The event sink.

IsEmpty

Gets a value indicating whether this instance is empty.

Declaration

public bool IsEmpty { get; }

Property Value

Type	Description
System.Boolean	`true` if this instance is empty; otherwise, `false`.

IsSynchronized

Gets a value indicating whether access to the System.Collections.ICollection is synchronized (thread safe).

Declaration

public bool IsSynchronized { get; }

Property Value

Type
System.Boolean

Members

Gets the collection members.

Declaration

public ArrayList Members { get; set; }

Property Value

Type	Description
System.Collections.ArrayList	The members.

Owner

Gets or sets the collection owner.

Declaration

public object Owner { get; set; }

Property Value

Type	Description
System.Object	The owner.

QuietMode

Gets or sets a value indicating whether quiet mode for events raising.

Declaration

public bool QuietMode { get; set; }

Property Value

Type
System.Boolean

SyncRoot

Gets an object that can be used to synchronize access to the System.Collections.ICollection.

Declaration

public object SyncRoot { get; }

Property Value

Type
System.Object

UpdateReferences

Gets or sets a value indicating whether members service references will be updated.

Declaration

public bool UpdateReferences { get; set; }

Property Value

Type
System.Boolean

Methods

AddRange(ICollection)

Adds an items to the CollectionEx.

Declaration

public void AddRange(ICollection values)

Parameters

Type	Name	Description
System.Collections.ICollection	values	The System.Collections.ICollection to add to the CollectionEx.

AddValue(Object)

Adds an item to the CollectionEx.

Declaration

protected int AddValue(object value)

Parameters

Type	Name	Description
System.Object	value	The System.Object to add to the CollectionEx.

Returns

Type	Description
System.Int32	The position into which the new element was inserted.

Clear()

Removes all items from the CollectionEx.

Declaration

public void Clear()

Clone()

Creates a new object that is a copy of the current instance.

Declaration

public abstract object Clone()

Returns

Type	Description
System.Object	A new object that is a copy of this instance.

CopyTo(Array, Int32)

Copies the elements of the System.Collections.ICollection to an System.Array, starting at a particular System.Array index.

Declaration

public void CopyTo(Array array, int index)

Parameters

Type	Name	Description
System.Array	array	The one-dimensional System.Array that is the destination of the elements copied from System.Collections.ICollection. The System.Array must have zero-based indexing.
System.Int32	index	The zero-based index in `array` at which copying begins.

Exceptions

Type	Condition
System.ArgumentNullException	`array` is null.
System.ArgumentOutOfRangeException	`index` is less than zero.
System.ArgumentException	`array` is multidimensional.-or- `index` is equal to or greater than the length of `array`.-or- The number of elements in the source System.Collections.ICollection is greater than the available space from `index` to the end of the destination `array`.
System.ArgumentException	The type of the source System.Collections.ICollection cannot be cast automatically to the type of the destination `array`.

GetEnumerator()

Returns an enumerator that iterates through a collection.

Declaration

public abstract IEnumerator GetEnumerator()

Returns

Type	Description
System.Collections.IEnumerator	An System.Collections.IEnumerator object that can be used to iterate through the collection.

GetObjectData(SerializationInfo, StreamingContext)

Populates a System.Runtime.Serialization.SerializationInfo with the data needed to serialize the target object.

Declaration

public virtual void GetObjectData(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	The System.Runtime.Serialization.SerializationInfo to populate with data.
System.Runtime.Serialization.StreamingContext	context	The destination (see System.Runtime.Serialization.StreamingContext) for this serialization.

Exceptions

Type	Condition
System.Security.SecurityException	The caller does not have the required permission.

InsertValue(Int32, Object)

Inserts an item to the CollectionEx at the specified index.

Declaration

protected void InsertValue(int index, object value)

Parameters

Type	Name	Description
System.Int32	index	The zero-based index ar which `index` should be inserted.
System.Object	value	The System.Object to insert into the CollectionEx.

OnChangesComplete(CollectionExEventArgs)

Raises the ChangesComplete event.

Declaration

protected virtual void OnChangesComplete(CollectionExEventArgs evtArgs)

Parameters

Type	Name	Description
CollectionExEventArgs	evtArgs	The CollectionExEventArgs instance containing the event data.

OnChanging(CollectionExEventArgs)

Raises the Changing event.

Declaration

protected virtual void OnChanging(CollectionExEventArgs evtArgs)

Parameters

Type	Name	Description
CollectionExEventArgs	evtArgs	The CollectionExEventArgs instance containing the event data.

OnValidate(ICollection)

Validates given values.

Declaration

protected abstract void OnValidate(ICollection values)

Parameters

Type	Name	Description
System.Collections.ICollection	values	The values to validate.

Exceptions

Type	Condition
System.InvalidCastException

OnValidate(Object)

Validates given value.

Declaration

protected abstract void OnValidate(object value)

Parameters

Type	Name	Description
System.Object	value	value to validate

Exceptions

Type	Condition
System.InvalidCastException

ProvideServiceReference(RuntimeTypeHandle)

Provides the service reference for object that use that instance.

Declaration

public object ProvideServiceReference(RuntimeTypeHandle typeHandle)

Parameters

Type	Name	Description
System.RuntimeTypeHandle	typeHandle	The type handle.

Returns

Type	Description
System.Object	The object.

RaiseChangesCompleteEvent(CollectionExEventArgs)

Raises ChangesComplete event.

Declaration

protected virtual void RaiseChangesCompleteEvent(CollectionExEventArgs evtArgs)

Parameters

Type	Name	Description
CollectionExEventArgs	evtArgs	event args

RaiseChangingEvent(CollectionExEventArgs)

Raise Changing event.

Declaration

protected virtual void RaiseChangingEvent(CollectionExEventArgs evtArgs)

Parameters

Type	Name	Description
CollectionExEventArgs	evtArgs	event args

RemoveAt(Int32)

Removes the CollectionEx item at the specified index.

Declaration

public void RemoveAt(int index)

Parameters

Type	Name	Description
System.Int32	index	The zero-based index of the item to remove.

Exceptions

Type	Condition
System.ArgumentOutOfRangeException	`index` is not a valid index in the CollectionEx.

RemoveRange(ICollection)

Removes the values occurrence of a specific object from the CollectionEx.

Declaration

protected void RemoveRange(ICollection values)

Parameters

Type	Name	Description
System.Collections.ICollection	values	The System.Collections.ICollection to remove from the CollectionEx.

RemoveValue(Object)

Removes the first occurrence of a specific object from the CollectionEx.

Declaration

protected bool RemoveValue(object value)

Parameters

Type	Name	Description
System.Object	value	The System.Object to remove from the CollectionEx.

Returns

Type	Description
System.Boolean	true, if remove value otherwise, false.

Set(Int32, Object)

Assigns new value to member in specified position .

Declaration

protected void Set(int index, object value)

Parameters

Type	Name	Description
System.Int32	index	The index of element.
System.Object	value	The new value to set.

Sort(IComparer)

Sort list using the specified comparer.

Declaration

public void Sort(IComparer comparer)

Parameters

Type	Name	Description
System.Collections.IComparer	comparer	The comparer to sort items.

UpdateServiceReferences(CollectionExEventArgs)

Updates the service references the collection members.

Declaration

protected virtual void UpdateServiceReferences(CollectionExEventArgs evtArgs)

Parameters

Type	Name	Description
CollectionExEventArgs	evtArgs	The CollectionExEventArgs instance containing the event data.

UpdateServiceReferences(IServiceReferenceProvider)

Updates the service references using service provider.

Declaration

public void UpdateServiceReferences(IServiceReferenceProvider provider)

Parameters

Type	Name	Description
IServiceReferenceProvider	provider	The service provider.

Implements

System.Collections.IList

System.Collections.ICollection

System.Collections.IEnumerable

System.ICloneable

System.Runtime.Serialization.ISerializable

IServiceReferenceHolder

IServiceReferenceProvider