/Blocks/Common/Src/Configuration/ConfigurationElementCollection.Silverlight.cs

//===============================================================================

// Microsoft patterns & practices Enterprise Library

// Core

//===============================================================================

// Copyright Š Microsoft Corporation.  All rights reserved.

// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY

// OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT

// LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND

// FITNESS FOR A PARTICULAR PURPOSE.

//===============================================================================



using System;

using System.Collections.Generic;

using System.Linq;

using System.Collections;

using Microsoft.Practices.EnterpriseLibrary.Common.Properties;



namespace Microsoft.Practices.EnterpriseLibrary.Common.Configuration

{

    /// <summary>

    /// Represents a strongly typed list of objects that can be accessed by index. Provides methods to search, sort, and manipulate lists.

    /// </summary>

    /// <typeparam name="T">The type of elements in the list.</typeparam>

    public class ConfigurationElementCollection<T> : IList<T>, IList

    {

        private readonly List<T> list = new List<T>();



        /// <summary>

        /// Determines the index of a specific item in the <see cref="T:System.Collections.Generic.IList`1"/>.

        /// </summary>

        /// <returns>

        /// The index of <paramref name="item"/> if found in the list; otherwise, -1.

        /// </returns>

        /// <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.IList`1"/>.</param>

        public int IndexOf(T item)

        {

            return this.list.IndexOf(item);

        }



        /// <summary>

        /// Inserts an item to the <see cref="T:System.Collections.Generic.IList`1"/> at the specified index.

        /// </summary>

        /// <param name="index">The zero-based index at which <paramref name="item"/> should be inserted.</param><param name="item">The object to insert into the <see cref="T:System.Collections.Generic.IList`1"/>.</param><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index"/> is not a valid index in the <see cref="T:System.Collections.Generic.IList`1"/>.</exception><exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IList`1"/> is read-only.</exception>

        public void Insert(int index, T item)

        {

            EnsureCanInsert(item);

            this.list.Insert(index, item);

        }



        /// <summary>

        /// Removes the <see cref="T:System.Collections.Generic.IList`1"/> item at the specified index.

        /// </summary>

        /// <param name="index">The zero-based index of the item to remove.</param><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index"/> is not a valid index in the <see cref="T:System.Collections.Generic.IList`1"/>.</exception><exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IList`1"/> is read-only.</exception>

        public void RemoveAt(int index)

        {

            this.list.RemoveAt(index);

        }



        /// <summary>

        /// Gets or sets the element at the specified index.

        /// </summary>

        /// <returns>

        /// The element at the specified index.

        /// </returns>

        /// <param name="index">The zero-based index of the element to get or set.</param><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index"/> is not a valid index in the <see cref="T:System.Collections.Generic.IList`1"/>.</exception><exception cref="T:System.NotSupportedException">The property is set and the <see cref="T:System.Collections.Generic.IList`1"/> is read-only.</exception>

        public T this[int index]

        {

            get { return this.list[index]; }

            set { this.list[index] = value; }

        }



        /// <summary>

        /// Adds an item to the <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </summary>

        /// <param name="item">The object to add to the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param><exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only.</exception>

        public void Add(T item)

        {

            EnsureCanInsert(item);

            this.list.Add(item);

        }



        /// <summary>

        /// Removes all items from the <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </summary>

        /// <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only. </exception>

        public void Clear()

        {

            this.list.Clear();

        }



        /// <summary>

        /// Determines whether the <see cref="T:System.Collections.Generic.ICollection`1"/> contains a specific value.

        /// </summary>

        /// <returns>

        /// true if <paramref name="item"/> is found in the <see cref="T:System.Collections.Generic.ICollection`1"/>; otherwise, false.

        /// </returns>

        /// <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param>

        public bool Contains(T item)

        {

            return this.list.Contains(item);

        }



        /// <summary>

        /// Copies the elements of the <see cref="T:System.Collections.Generic.ICollection`1"/> to an <see cref="T:System.Array"/>, starting at a particular <see cref="T:System.Array"/> index.

        /// </summary>

        /// <param name="array">The one-dimensional <see cref="T:System.Array"/> that is the destination of the elements copied from <see cref="T:System.Collections.Generic.ICollection`1"/>. The <see cref="T:System.Array"/> must have zero-based indexing.</param><param name="arrayIndex">The zero-based index in <paramref name="array"/> at which copying begins.</param><exception cref="T:System.ArgumentNullException"><paramref name="array"/> is null.</exception><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="arrayIndex"/> is less than 0.</exception><exception cref="T:System.ArgumentException"><paramref name="array"/> is multidimensional.-or-The number of elements in the source <see cref="T:System.Collections.Generic.ICollection`1"/> is greater than the available space from <paramref name="arrayIndex"/> to the end of the destination <paramref name="array"/>.-or-Type <typeparamref name="T"/> cannot be cast automatically to the type of the destination <paramref name="array"/>.</exception>

        public void CopyTo(T[] array, int arrayIndex)

        {

            this.list.CopyTo(array, arrayIndex);

        }



        /// <summary>

        /// Gets the number of elements contained in the <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </summary>

        /// <returns>

        /// The number of elements contained in the <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </returns>

        public int Count

        {

            get { return this.list.Count; }

        }



        /// <summary>

        /// Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only.

        /// </summary>

        /// <returns>

        /// true if the <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only; otherwise, false.

        /// </returns>

        public bool IsReadOnly

        {

            get { return ((IList<T>)this.list).IsReadOnly; }

        }



        /// <summary>

        /// Removes the first occurrence of a specific object from the <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </summary>

        /// <returns>

        /// true if <paramref name="item"/> was successfully removed from the <see cref="T:System.Collections.Generic.ICollection`1"/>; otherwise, false. This method also returns false if <paramref name="item"/> is not found in the original <see cref="T:System.Collections.Generic.ICollection`1"/>.

        /// </returns>

        /// <param name="item">The object to remove from the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param><exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only.</exception>

        public bool Remove(T item)

        {

            return this.list.Remove(item);

        }



        /// <summary>

        /// Returns an enumerator that iterates through the collection.

        /// </summary>

        /// <returns>

        /// A <see cref="T:System.Collections.Generic.IEnumerator`1"/> that can be used to iterate through the collection.

        /// </returns>

        public IEnumerator<T> GetEnumerator()

        {

            return this.list.GetEnumerator();

        }



        /// <summary>

        /// Determines if the item can be inserted into the collection.

        /// </summary>

        /// <param name="item">The item to check.</param>

        /// <returns><see langword="true" /> if the item can be inserted.</returns>

        protected virtual bool CanInsert(T item)

        {

            return true;

        }



        private void EnsureCanInsert(T item)

        {

            if (item == null) throw new ArgumentNullException("item");

            if (!this.CanInsert(item)) throw new ArgumentException(Resources.ConfigurationElementCollection_CannotInsert, "item");

        }



        IEnumerator IEnumerable.GetEnumerator()

        {

            return this.GetEnumerator();

        }



        int IList.Add(object value)

        {

            this.Add((T)value);

            return this.Count - 1;

        }



        bool IList.Contains(object value)

        {

            return this.Contains((T)value);

        }



        int IList.IndexOf(object value)

        {

            return this.IndexOf((T)value);

        }



        void IList.Insert(int index, object value)

        {

            this.Insert(index, (T)value);

        }



        bool IList.IsFixedSize

        {

            get { return ((IList)this.list).IsFixedSize; }

        }



        void IList.Remove(object value)

        {

            this.Remove((T)value);

        }



        object IList.this[int index]

        {

            get { return this[index]; }

            set { this[index] = (T)value; }

        }



        void ICollection.CopyTo(Array array, int index)

        {

            ((IList)this.list).CopyTo(array, index);

        }



        bool ICollection.IsSynchronized

        {

            get { return ((IList)this.list).IsSynchronized; }

        }



        object ICollection.SyncRoot

        {

            get { return ((IList)this.list).SyncRoot; }

        }

    }

}